Is Map Traveler free?

Yes, Map Traveler is free to use.

How do I install Map Traveler?

Map Traveler is a local plugin. Install it using npm package: @mfukushim/map-traveler-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Map Traveler need?

Map Traveler requires the following credentials or environment variables: MT_GOOGLE_MAP_KEY, MT_GEMINI_IMAGE_KEY, MT_MAX_RETRY_GEMINI, MT_AVATAR_IMAGE_URI, MT_MAP_API_URL, MT_TIME_SCALE, MT_SQLITE_PATH, MT_TURSO_URL, MT_TURSO_TOKEN, MT_REMBG_PATH, MT_REMBG_URL, MT_REMBG_WO_KEY, MT_PIXAI_KEY, MT_SD_KEY, MT_PIXAI_MODEL_ID, MT_COMFY_URL, MT_COMFY_WORKFLOW_T2I, MT_COMFY_WORKFLOW_I2I, MT_COMFY_PARAMS, MT_FIXED_MODEL_PROMPT, MT_BODY_AREA_RATIO, MT_BODY_HW_RATIO, MT_BODY_WINDOW_RATIO_W, MT_BODY_WINDOW_RATIO_H, MT_BS_ID, MT_BS_PASS, MT_BS_HANDLE, MT_FILTER_TOOLS, MT_MOVE_MODE, MT_IMAGE_WIDTH, MT_NO_IMAGE, MT_NO_AVATAR, MT_FEED_TAG, MT_MAX_SESSIONS, MT_SESSION_TTL_MS, MT_SERVICE_TTL_MS. You can find setup instructions on the server detail page.

What AI apps work with Map Traveler?

Map Traveler uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Map Traveler

by Mfukushim

Developer ToolsLow Risk10.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

Virtual traveler library for MCP

About

Virtual traveler library for MCP

What You'll Need

Set these up before or after installing:

[Map] Google Map API keyRequired

Environment variable: MT_GOOGLE_MAP_KEY

[Image.gemini] Gemini Image Api keyRequired

Environment variable: MT_GEMINI_IMAGE_KEY

[Image.gemini] Number of retries when generating Gemini images Default: 0Optional

Environment variable: MT_MAX_RETRY_GEMINI

[Image.gemini] Character reference image uri (file:// or https://) when generating Gemini image. Multiple settings can be made by separating them with the '|'. When multiple settings are made, they will be selected randomly.Optional

Environment variable: MT_AVATAR_IMAGE_URI

[Map.etc] Optional: Map API custom endpoint. Example: direction=https://xxxx,places=https://yyyy Optional

Environment variable: MT_MAP_API_URL

[Map] Optional:Scale of travel time on real roads duration. default 4Optional

Environment variable: MT_TIME_SCALE

[db.local] db save path: e.g. %USERPROFILE%/Desktop/traveler.sqlite ,$HOME/traveler.sqlite Optional

Environment variable: MT_SQLITE_PATH

[db.api] Turso sqlite API URLOptional

Environment variable: MT_TURSO_URL

[db.api] Turso sqlite API access tokenRequired

Environment variable: MT_TURSO_TOKEN

[rembg.local] absolute path of the installed rembg cliOptional

Environment variable: MT_REMBG_PATH

[rembg.api] withoutbg.com rembg API URLOptional

Environment variable: MT_REMBG_URL

[rembg.api] withoutbg.com rembg API keyRequired

Environment variable: MT_REMBG_WO_KEY

[Image.pixAi] pixAi API keyRequired

Environment variable: MT_PIXAI_KEY

[Image.sd] Stability.ai image generation API keyRequired

Environment variable: MT_SD_KEY

[Image.pixAi] Optional: pixAi ModelId, if not set use default model 1648918127446573124 Optional

Environment variable: MT_PIXAI_MODEL_ID

[Image.local.ComfyUi] Option: Generate image using ComfyUI API at specified URL. Example: http://192.168.1.100:8188Optional

Environment variable: MT_COMFY_URL

[Image.local.ComfyUi] Optional: Path to API workflow file when using text to image with ComfyUI. If not specified: assets/comfy/t2i_sample.jsonOptional

Environment variable: MT_COMFY_WORKFLOW_T2I

[Image.local.ComfyUi] Optional: Path of API workflow file when image to image in ComfyUI. If not specified: assets/comfy/i2i_sample.jsonOptional

Environment variable: MT_COMFY_WORKFLOW_I2I

[Image.local.ComfyUi] Optional: Variable values to send to the workflow via comfyUI APIOptional

Environment variable: MT_COMFY_PARAMS

[Image] Optional: Fixed avatar generation prompt. You will no longer be able to change your avatar during conversations.Optional

Environment variable: MT_FIXED_MODEL_PROMPT

[Image] Optional: Acceptable avatar image area ratio. default 0.042Optional

Environment variable: MT_BODY_AREA_RATIO

[Image] Optional: Acceptable avatar image aspect ratios. default 1.5~2.3Optional

Environment variable: MT_BODY_HW_RATIO

[Image] Optional: Avatar composite window horizontal ratio. default 0.5Optional

Environment variable: MT_BODY_WINDOW_RATIO_W

[Image] Optional: Avatar composite window aspect ratio. default 0.75Optional

Environment variable: MT_BODY_WINDOW_RATIO_H

[Sns.Bs] Bluesky sns registration addressOptional

Environment variable: MT_BS_ID

[Sns.Bs] bluesky sns passwordRequired

Environment variable: MT_BS_PASS

[Sns.Bs] bluesky sns handle name: e.g. xxxxxxxx.bsky.social Optional

Environment variable: MT_BS_HANDLE

[etc] Optional: Directly filter the tools to be used. All are available if not specified. e.g. tips,set_traveler_locationOptional

Environment variable: MT_FILTER_TOOLS

[etc] Option: Specify whether the movement mode is 'realtime' or 'skip'. default realtimeOptional

Environment variable: MT_MOVE_MODE

[Image] Option: Output image width (pixels) Default is 512Optional

Environment variable: MT_IMAGE_WIDTH

[Image] Options: 'true' = do not output image, not specified = output image if possible, default is not specifiedOptional

Environment variable: MT_NO_IMAGE

[Image] Option: 'true' = Output StreetView image as is without avatar superimposition. Not specified = Superimpose avatar image. Default is not specified.Optional

Environment variable: MT_NO_AVATAR

[Sns] Optional: Specify the feed tag when posting to SNS (#required, 15 characters or more) Default is #geo_less_travelerOptional

Environment variable: MT_FEED_TAG

[Streamable-http] Maximum number of sessions when using Streamable-httpOptional

Environment variable: MT_MAX_SESSIONS

[Streamable-http] Session TTL when using Streamable-httpOptional

Environment variable: MT_SESSION_TTL_MS

[Streamable-http] Service TTL when using Streamable-httpOptional

Environment variable: MT_SERVICE_TTL_MS

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-mfukushim-map-traveler-mcp": {
      "env": {
        "MT_BS_ID": "your-mt-bs-id-here",
        "MT_SD_KEY": "your-mt-sd-key-here",
        "MT_BS_PASS": "your-mt-bs-pass-here",
        "MT_FEED_TAG": "your-mt-feed-tag-here",
        "MT_NO_IMAGE": "your-mt-no-image-here",
        "MT_BS_HANDLE": "your-mt-bs-handle-here",
        "MT_COMFY_URL": "your-mt-comfy-url-here",
        "MT_MOVE_MODE": "your-mt-move-mode-here",
        "MT_NO_AVATAR": "your-mt-no-avatar-here",
        "MT_PIXAI_KEY": "your-mt-pixai-key-here",
        "MT_REMBG_URL": "your-mt-rembg-url-here",
        "MT_TURSO_URL": "your-mt-turso-url-here",
        "MT_REMBG_PATH": "your-mt-rembg-path-here",
        "MT_TIME_SCALE": "your-mt-time-scale-here",
        "MT_IMAGE_WIDTH": "your-mt-image-width-here",
        "MT_MAP_API_URL": "your-mt-map-api-url-here",
        "MT_SQLITE_PATH": "your-mt-sqlite-path-here",
        "MT_TURSO_TOKEN": "your-mt-turso-token-here",
        "MT_COMFY_PARAMS": "your-mt-comfy-params-here",
        "MT_FILTER_TOOLS": "your-mt-filter-tools-here",
        "MT_MAX_SESSIONS": "your-mt-max-sessions-here",
        "MT_REMBG_WO_KEY": "your-mt-rembg-wo-key-here",
        "MT_BODY_HW_RATIO": "your-mt-body-hw-ratio-here",
        "MT_GOOGLE_MAP_KEY": "your-mt-google-map-key-here",
        "MT_PIXAI_MODEL_ID": "your-mt-pixai-model-id-here",
        "MT_SERVICE_TTL_MS": "your-mt-service-ttl-ms-here",
        "MT_SESSION_TTL_MS": "your-mt-session-ttl-ms-here",
        "MT_BODY_AREA_RATIO": "your-mt-body-area-ratio-here",
        "MT_AVATAR_IMAGE_URI": "your-mt-avatar-image-uri-here",
        "MT_GEMINI_IMAGE_KEY": "your-mt-gemini-image-key-here",
        "MT_MAX_RETRY_GEMINI": "your-mt-max-retry-gemini-here",
        "MT_COMFY_WORKFLOW_I2I": "your-mt-comfy-workflow-i2i-here",
        "MT_COMFY_WORKFLOW_T2I": "your-mt-comfy-workflow-t2i-here",
        "MT_FIXED_MODEL_PROMPT": "your-mt-fixed-model-prompt-here",
        "MT_BODY_WINDOW_RATIO_H": "your-mt-body-window-ratio-h-here",
        "MT_BODY_WINDOW_RATIO_W": "your-mt-body-window-ratio-w-here"
      },
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "command": "npx"
    }
  }
}

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author mfukushim (3/3 approved).

Scanned 3 files · 1 finding

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

network_websocket

Check that this permission is expected for this type of plugin.

Reviews

No reviews yet

Be the first to review this server!