Map Traveler Mcp

io.github.mfukushim/map-traveler-mcp · v0.1.4

Virtual traveler library for MCP

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add map-traveler-mcp -e MT_GOOGLE_MAP_KEY=<MT_GOOGLE_MAP_KEY> -e MT_GEMINI_IMAGE_KEY=<MT_GEMINI_IMAGE_KEY> -e MT_MAX_RETRY_GEMINI=<MT_MAX_RETRY_GEMINI> -e MT_AVATAR_IMAGE_URI=<MT_AVATAR_IMAGE_URI> -e MT_MAP_API_URL=<MT_MAP_API_URL> -e MT_TIME_SCALE=<MT_TIME_SCALE> -e MT_SQLITE_PATH=<MT_SQLITE_PATH> -e MT_TURSO_URL=<MT_TURSO_URL> -e MT_TURSO_TOKEN=<MT_TURSO_TOKEN> -e MT_REMBG_PATH=<MT_REMBG_PATH> -e MT_REMBG_URL=<MT_REMBG_URL> -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_PIXAI_MODEL_ID=<MT_PIXAI_MODEL_ID> -e MT_COMFY_URL=<MT_COMFY_URL> -e MT_COMFY_WORKFLOW_T2I=<MT_COMFY_WORKFLOW_T2I> -e MT_COMFY_WORKFLOW_I2I=<MT_COMFY_WORKFLOW_I2I> -e MT_COMFY_PARAMS=<MT_COMFY_PARAMS> -e MT_FIXED_MODEL_PROMPT=<MT_FIXED_MODEL_PROMPT> -e MT_BODY_AREA_RATIO=<MT_BODY_AREA_RATIO> -e MT_BODY_HW_RATIO=<MT_BODY_HW_RATIO> -e MT_BODY_WINDOW_RATIO_W=<MT_BODY_WINDOW_RATIO_W> -e MT_BODY_WINDOW_RATIO_H=<MT_BODY_WINDOW_RATIO_H> -e MT_BS_ID=<MT_BS_ID> -e MT_BS_PASS=<MT_BS_PASS> -e MT_BS_HANDLE=<MT_BS_HANDLE> -e MT_FILTER_TOOLS=<MT_FILTER_TOOLS> -e MT_MOVE_MODE=<MT_MOVE_MODE> -e MT_IMAGE_WIDTH=<MT_IMAGE_WIDTH> -e MT_NO_IMAGE=<MT_NO_IMAGE> -e MT_NO_AVATAR=<MT_NO_AVATAR> -e MT_FEED_TAG=<MT_FEED_TAG> -e MT_MAX_SESSIONS=<MT_MAX_SESSIONS> -e MT_SESSION_TTL_MS=<MT_SESSION_TTL_MS> -e MT_SERVICE_TTL_MS=<MT_SERVICE_TTL_MS> -- npx -y @mfukushim/[email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "map-traveler-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/[email protected]"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<MT_REMBG_PATH>",
        "MT_REMBG_URL": "<MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<MT_PIXAI_KEY>",
        "MT_SD_KEY": "<MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<MT_BS_ID>",
        "MT_BS_PASS": "<MT_BS_PASS>",
        "MT_BS_HANDLE": "<MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<MT_NO_AVATAR>",
        "MT_FEED_TAG": "<MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<MT_SERVICE_TTL_MS>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "map-traveler-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/[email protected]"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<MT_REMBG_PATH>",
        "MT_REMBG_URL": "<MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<MT_PIXAI_KEY>",
        "MT_SD_KEY": "<MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<MT_BS_ID>",
        "MT_BS_PASS": "<MT_BS_PASS>",
        "MT_BS_HANDLE": "<MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<MT_NO_AVATAR>",
        "MT_FEED_TAG": "<MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<MT_SERVICE_TTL_MS>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "map-traveler-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/[email protected]"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<MT_REMBG_PATH>",
        "MT_REMBG_URL": "<MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<MT_PIXAI_KEY>",
        "MT_SD_KEY": "<MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<MT_BS_ID>",
        "MT_BS_PASS": "<MT_BS_PASS>",
        "MT_BS_HANDLE": "<MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<MT_NO_AVATAR>",
        "MT_FEED_TAG": "<MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<MT_SERVICE_TTL_MS>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

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

Details

Package	`@mfukushim/[email protected]` (NPM, stdio)
First published	11 Sep 2025
Last updated	11 Sep 2025
Registry name	`io.github.mfukushim/map-traveler-mcp`

More data and analytics servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Map Traveler Mcp often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-mfukushim-map-traveler-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-mfukushim-map-traveler-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.