Map Traveler MCP Server

by mfukushimai.smithery/mfukushim-map-traveler-mcpv0.2.0

Create immersive travel experiences by instructing an avatar to navigate Google Maps. Report on th…

24Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Map Traveler MCP server

claude mcp add map-traveler -e MT_GOOGLE_MAP_KEY='<mt-google-map-key>' -e MT_GEMINI_IMAGE_KEY='<mt-gemini-image-key>' -e MT_TURSO_TOKEN='<mt-turso-token>' -e MT_REMBG_WO_KEY='<mt-rembg-wo-key>' -e MT_PIXAI_KEY='<mt-pixai-key>' -e MT_SD_KEY='<mt-sd-key>' -e MT_BS_PASS='<mt-bs-pass>' -- npx -y @mfukushim/map-traveler-mcp

{
  "mcpServers": {
    "map-traveler": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<mt-google-map-key>",
        "MT_GEMINI_IMAGE_KEY": "<mt-gemini-image-key>",
        "MT_TURSO_TOKEN": "<mt-turso-token>",
        "MT_REMBG_WO_KEY": "<mt-rembg-wo-key>",
        "MT_PIXAI_KEY": "<mt-pixai-key>",
        "MT_SD_KEY": "<mt-sd-key>",
        "MT_BS_PASS": "<mt-bs-pass>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "map-traveler": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<mt-google-map-key>",
        "MT_GEMINI_IMAGE_KEY": "<mt-gemini-image-key>",
        "MT_TURSO_TOKEN": "<mt-turso-token>",
        "MT_REMBG_WO_KEY": "<mt-rembg-wo-key>",
        "MT_PIXAI_KEY": "<mt-pixai-key>",
        "MT_SD_KEY": "<mt-sd-key>",
        "MT_BS_PASS": "<mt-bs-pass>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "map-traveler": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<mt-google-map-key>",
        "MT_GEMINI_IMAGE_KEY": "<mt-gemini-image-key>",
        "MT_TURSO_TOKEN": "<mt-turso-token>",
        "MT_REMBG_WO_KEY": "<mt-rembg-wo-key>",
        "MT_PIXAI_KEY": "<mt-pixai-key>",
        "MT_SD_KEY": "<mt-sd-key>",
        "MT_BS_PASS": "<mt-bs-pass>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "map-traveler": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<mt-google-map-key>",
        "MT_GEMINI_IMAGE_KEY": "<mt-gemini-image-key>",
        "MT_TURSO_TOKEN": "<mt-turso-token>",
        "MT_REMBG_WO_KEY": "<mt-rembg-wo-key>",
        "MT_PIXAI_KEY": "<mt-pixai-key>",
        "MT_SD_KEY": "<mt-sd-key>",
        "MT_BS_PASS": "<mt-bs-pass>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MT_GOOGLE_MAP_KEY	—	yes	[Map] Google Map API key
MT_GEMINI_IMAGE_KEY	—	yes	[Image.gemini] Gemini Image Api key
MT_MAX_RETRY_GEMINI	—	—	[Image.gemini] Number of retries when generating Gemini images Default: 0
MT_AVATAR_IMAGE_URI	—	—	[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.
MT_MAP_API_URL	—	—	[Map.etc] Optional: Map API custom endpoint. Example: direction=https://xxxx,places=https://yyyy
MT_TIME_SCALE	—	—	[Map] Optional:Scale of travel time on real roads duration. default 4
MT_SQLITE_PATH	—	—	[db.local] db save path: e.g. %USERPROFILE%/Desktop/traveler.sqlite ,$HOME/traveler.sqlite
MT_TURSO_URL	—	—	[db.api] Turso sqlite API URL
MT_TURSO_TOKEN	—	yes	[db.api] Turso sqlite API access token
MT_REMBG_PATH	—	—	[rembg.local] absolute path of the installed rembg cli
MT_REMBG_URL	—	—	[rembg.api] withoutbg.com rembg API URL
MT_REMBG_WO_KEY	—	yes	[rembg.api] withoutbg.com rembg API key
MT_PIXAI_KEY	—	yes	[Image.pixAi] pixAi API key
MT_SD_KEY	—	yes	[Image.sd] Stability.ai image generation API key
MT_PIXAI_MODEL_ID	—	—	[Image.pixAi] Optional: pixAi ModelId, if not set use default model 1648918127446573124
MT_COMFY_URL	—	—	[Image.local.ComfyUi] Option: Generate image using ComfyUI API at specified URL. Example: http://192.168.1.100:8188
MT_COMFY_WORKFLOW_T2I	—	—	[Image.local.ComfyUi] Optional: Path to API workflow file when using text to image with ComfyUI. If not specified: assets/comfy/t2i_sample.json
MT_COMFY_WORKFLOW_I2I	—	—	[Image.local.ComfyUi] Optional: Path of API workflow file when image to image in ComfyUI. If not specified: assets/comfy/i2i_sample.json
MT_COMFY_PARAMS	—	—	[Image.local.ComfyUi] Optional: Variable values to send to the workflow via comfyUI API
MT_FIXED_MODEL_PROMPT	—	—	[Image] Optional: Fixed avatar generation prompt. You will no longer be able to change your avatar during conversations.
MT_BODY_AREA_RATIO	—	—	[Image] Optional: Acceptable avatar image area ratio. default 0.042
MT_BODY_HW_RATIO	—	—	[Image] Optional: Acceptable avatar image aspect ratios. default 1.5~2.3
MT_BODY_WINDOW_RATIO_W	—	—	[Image] Optional: Avatar composite window horizontal ratio. default 0.5
MT_BODY_WINDOW_RATIO_H	—	—	[Image] Optional: Avatar composite window aspect ratio. default 0.75
MT_BS_ID	—	—	[Sns.Bs] Bluesky sns registration address
MT_BS_PASS	—	yes	[Sns.Bs] bluesky sns password
MT_BS_HANDLE	—	—	[Sns.Bs] bluesky sns handle name: e.g. xxxxxxxx.bsky.social
MT_FILTER_TOOLS	—	—	[etc] Optional: Directly filter the tools to be used. All are available if not specified. e.g. tips,set_traveler_location
MT_MOVE_MODE	—	—	[etc] Option: Specify whether the movement mode is 'realtime' or 'skip'. default realtime
MT_IMAGE_WIDTH	—	—	[Image] Option: Output image width (pixels) Default is 512
MT_NO_IMAGE	—	—	[Image] Options: 'true' = do not output image, not specified = output image if possible, default is not specified
MT_NO_AVATAR	—	—	[Image] Option: 'true' = Output StreetView image as is without avatar superimposition. Not specified = Superimpose avatar image. Default is not specified.
MT_FEED_TAG	—	—	[Sns] Optional: Specify the feed tag when posting to SNS (#required, 15 characters or more) Default is #geo_less_traveler
MT_MAX_SESSIONS	—	—	[Streamable-http] Maximum number of sessions when using Streamable-http
MT_SESSION_TTL_MS	—	—	[Streamable-http] Session TTL when using Streamable-http
MT_SERVICE_TTL_MS	—	—	[Streamable-http] Service TTL when using Streamable-http

Remote endpoints

streamable-httphttps://server.smithery.ai/@mfukushim/map-traveler-mcp/mcp

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-03 · 2mo ago · GitHub
Latest release
2025-10-16 · 12mo ago · GitHub · v0.1.7
Package published
no data · npm/PyPI
Registry entry updated
2025-09-29 · 13mo ago · official registry · v0.2.0

FAQ

›How do I install the Map Traveler MCP server in Claude Code?

Run: claude mcp add map-traveler -e MT_GOOGLE_MAP_KEY='<mt-google-map-key>' -e MT_GEMINI_IMAGE_KEY='<mt-gemini-image-key>' -e MT_TURSO_TOKEN='<mt-turso-token>' -e MT_REMBG_WO_KEY='<mt-rembg-wo-key>' -e MT_PIXAI_KEY='<mt-pixai-key>' -e MT_SD_KEY='<mt-sd-key>' -e MT_BS_PASS='<mt-bs-pass>' -- npx -y @mfukushim/map-traveler-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Map Traveler require an API key?

Yes. It expects MT_GOOGLE_MAP_KEY, MT_GEMINI_IMAGE_KEY, MT_TURSO_TOKEN, MT_REMBG_WO_KEY, MT_PIXAI_KEY, MT_SD_KEY, MT_BS_PASS, of which 7 are secrets.

›Can I use Map Traveler as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Map Traveler in the official MCP registry?

Yes, as ai.smithery/mfukushim-map-traveler-mcp.