PluginBench
MCP Server

io.github.mfukushim/map-traveler-mcp MCP Server

io.github.mfukushim/map-traveler-mcp

RepositoryRegistry

What is the io.github.mfukushim/map-traveler-mcp MCP server?

Virtual traveler library for MCP

How to install io.github.mfukushim/map-traveler-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • MT_GOOGLE_MAP_KEY
    secret

    [Map] Google Map API key

  • MT_GEMINI_IMAGE_KEY
    secret

    [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
    secret

    [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
    secret

    [rembg.api] withoutbg.com rembg API key

  • MT_PIXAI_KEY
    secret

    [Image.pixAi] pixAi API key

  • MT_SD_KEY
    secret

    [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
    secret

    [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

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "map-traveler-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<YOUR_MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<YOUR_MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<YOUR_MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<YOUR_MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<YOUR_MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<YOUR_MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<YOUR_MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<YOUR_MT_REMBG_PATH>",
        "MT_REMBG_URL": "<YOUR_MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<YOUR_MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<YOUR_MT_PIXAI_KEY>",
        "MT_SD_KEY": "<YOUR_MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<YOUR_MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<YOUR_MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<YOUR_MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<YOUR_MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<YOUR_MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<YOUR_MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<YOUR_MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<YOUR_MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<YOUR_MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<YOUR_MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<YOUR_MT_BS_ID>",
        "MT_BS_PASS": "<YOUR_MT_BS_PASS>",
        "MT_BS_HANDLE": "<YOUR_MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<YOUR_MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<YOUR_MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<YOUR_MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<YOUR_MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<YOUR_MT_NO_AVATAR>",
        "MT_FEED_TAG": "<YOUR_MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<YOUR_MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<YOUR_MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<YOUR_MT_SERVICE_TTL_MS>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "map-traveler-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<YOUR_MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<YOUR_MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<YOUR_MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<YOUR_MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<YOUR_MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<YOUR_MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<YOUR_MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<YOUR_MT_REMBG_PATH>",
        "MT_REMBG_URL": "<YOUR_MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<YOUR_MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<YOUR_MT_PIXAI_KEY>",
        "MT_SD_KEY": "<YOUR_MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<YOUR_MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<YOUR_MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<YOUR_MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<YOUR_MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<YOUR_MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<YOUR_MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<YOUR_MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<YOUR_MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<YOUR_MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<YOUR_MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<YOUR_MT_BS_ID>",
        "MT_BS_PASS": "<YOUR_MT_BS_PASS>",
        "MT_BS_HANDLE": "<YOUR_MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<YOUR_MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<YOUR_MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<YOUR_MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<YOUR_MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<YOUR_MT_NO_AVATAR>",
        "MT_FEED_TAG": "<YOUR_MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<YOUR_MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<YOUR_MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<YOUR_MT_SERVICE_TTL_MS>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "map-traveler-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<YOUR_MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<YOUR_MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<YOUR_MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<YOUR_MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<YOUR_MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<YOUR_MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<YOUR_MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<YOUR_MT_REMBG_PATH>",
        "MT_REMBG_URL": "<YOUR_MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<YOUR_MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<YOUR_MT_PIXAI_KEY>",
        "MT_SD_KEY": "<YOUR_MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<YOUR_MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<YOUR_MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<YOUR_MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<YOUR_MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<YOUR_MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<YOUR_MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<YOUR_MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<YOUR_MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<YOUR_MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<YOUR_MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<YOUR_MT_BS_ID>",
        "MT_BS_PASS": "<YOUR_MT_BS_PASS>",
        "MT_BS_HANDLE": "<YOUR_MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<YOUR_MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<YOUR_MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<YOUR_MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<YOUR_MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<YOUR_MT_NO_AVATAR>",
        "MT_FEED_TAG": "<YOUR_MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<YOUR_MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<YOUR_MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<YOUR_MT_SERVICE_TTL_MS>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "map-traveler-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "<YOUR_MT_GOOGLE_MAP_KEY>",
        "MT_GEMINI_IMAGE_KEY": "<YOUR_MT_GEMINI_IMAGE_KEY>",
        "MT_MAX_RETRY_GEMINI": "<YOUR_MT_MAX_RETRY_GEMINI>",
        "MT_AVATAR_IMAGE_URI": "<YOUR_MT_AVATAR_IMAGE_URI>",
        "MT_MAP_API_URL": "<YOUR_MT_MAP_API_URL>",
        "MT_TIME_SCALE": "<YOUR_MT_TIME_SCALE>",
        "MT_SQLITE_PATH": "<YOUR_MT_SQLITE_PATH>",
        "MT_TURSO_URL": "<YOUR_MT_TURSO_URL>",
        "MT_TURSO_TOKEN": "<YOUR_MT_TURSO_TOKEN>",
        "MT_REMBG_PATH": "<YOUR_MT_REMBG_PATH>",
        "MT_REMBG_URL": "<YOUR_MT_REMBG_URL>",
        "MT_REMBG_WO_KEY": "<YOUR_MT_REMBG_WO_KEY>",
        "MT_PIXAI_KEY": "<YOUR_MT_PIXAI_KEY>",
        "MT_SD_KEY": "<YOUR_MT_SD_KEY>",
        "MT_PIXAI_MODEL_ID": "<YOUR_MT_PIXAI_MODEL_ID>",
        "MT_COMFY_URL": "<YOUR_MT_COMFY_URL>",
        "MT_COMFY_WORKFLOW_T2I": "<YOUR_MT_COMFY_WORKFLOW_T2I>",
        "MT_COMFY_WORKFLOW_I2I": "<YOUR_MT_COMFY_WORKFLOW_I2I>",
        "MT_COMFY_PARAMS": "<YOUR_MT_COMFY_PARAMS>",
        "MT_FIXED_MODEL_PROMPT": "<YOUR_MT_FIXED_MODEL_PROMPT>",
        "MT_BODY_AREA_RATIO": "<YOUR_MT_BODY_AREA_RATIO>",
        "MT_BODY_HW_RATIO": "<YOUR_MT_BODY_HW_RATIO>",
        "MT_BODY_WINDOW_RATIO_W": "<YOUR_MT_BODY_WINDOW_RATIO_W>",
        "MT_BODY_WINDOW_RATIO_H": "<YOUR_MT_BODY_WINDOW_RATIO_H>",
        "MT_BS_ID": "<YOUR_MT_BS_ID>",
        "MT_BS_PASS": "<YOUR_MT_BS_PASS>",
        "MT_BS_HANDLE": "<YOUR_MT_BS_HANDLE>",
        "MT_FILTER_TOOLS": "<YOUR_MT_FILTER_TOOLS>",
        "MT_MOVE_MODE": "<YOUR_MT_MOVE_MODE>",
        "MT_IMAGE_WIDTH": "<YOUR_MT_IMAGE_WIDTH>",
        "MT_NO_IMAGE": "<YOUR_MT_NO_IMAGE>",
        "MT_NO_AVATAR": "<YOUR_MT_NO_AVATAR>",
        "MT_FEED_TAG": "<YOUR_MT_FEED_TAG>",
        "MT_MAX_SESSIONS": "<YOUR_MT_MAX_SESSIONS>",
        "MT_SESSION_TTL_MS": "<YOUR_MT_SESSION_TTL_MS>",
        "MT_SERVICE_TTL_MS": "<YOUR_MT_SERVICE_TTL_MS>"
      }
    }
  }
}
Claude Code
claude mcp add map-traveler-mcp --env MT_GOOGLE_MAP_KEY=<YOUR_MT_GOOGLE_MAP_KEY> --env MT_GEMINI_IMAGE_KEY=<YOUR_MT_GEMINI_IMAGE_KEY> --env MT_MAX_RETRY_GEMINI=<YOUR_MT_MAX_RETRY_GEMINI> --env MT_AVATAR_IMAGE_URI=<YOUR_MT_AVATAR_IMAGE_URI> --env MT_MAP_API_URL=<YOUR_MT_MAP_API_URL> --env MT_TIME_SCALE=<YOUR_MT_TIME_SCALE> --env MT_SQLITE_PATH=<YOUR_MT_SQLITE_PATH> --env MT_TURSO_URL=<YOUR_MT_TURSO_URL> --env MT_TURSO_TOKEN=<YOUR_MT_TURSO_TOKEN> --env MT_REMBG_PATH=<YOUR_MT_REMBG_PATH> --env MT_REMBG_URL=<YOUR_MT_REMBG_URL> --env MT_REMBG_WO_KEY=<YOUR_MT_REMBG_WO_KEY> --env MT_PIXAI_KEY=<YOUR_MT_PIXAI_KEY> --env MT_SD_KEY=<YOUR_MT_SD_KEY> --env MT_PIXAI_MODEL_ID=<YOUR_MT_PIXAI_MODEL_ID> --env MT_COMFY_URL=<YOUR_MT_COMFY_URL> --env MT_COMFY_WORKFLOW_T2I=<YOUR_MT_COMFY_WORKFLOW_T2I> --env MT_COMFY_WORKFLOW_I2I=<YOUR_MT_COMFY_WORKFLOW_I2I> --env MT_COMFY_PARAMS=<YOUR_MT_COMFY_PARAMS> --env MT_FIXED_MODEL_PROMPT=<YOUR_MT_FIXED_MODEL_PROMPT> --env MT_BODY_AREA_RATIO=<YOUR_MT_BODY_AREA_RATIO> --env MT_BODY_HW_RATIO=<YOUR_MT_BODY_HW_RATIO> --env MT_BODY_WINDOW_RATIO_W=<YOUR_MT_BODY_WINDOW_RATIO_W> --env MT_BODY_WINDOW_RATIO_H=<YOUR_MT_BODY_WINDOW_RATIO_H> --env MT_BS_ID=<YOUR_MT_BS_ID> --env MT_BS_PASS=<YOUR_MT_BS_PASS> --env MT_BS_HANDLE=<YOUR_MT_BS_HANDLE> --env MT_FILTER_TOOLS=<YOUR_MT_FILTER_TOOLS> --env MT_MOVE_MODE=<YOUR_MT_MOVE_MODE> --env MT_IMAGE_WIDTH=<YOUR_MT_IMAGE_WIDTH> --env MT_NO_IMAGE=<YOUR_MT_NO_IMAGE> --env MT_NO_AVATAR=<YOUR_MT_NO_AVATAR> --env MT_FEED_TAG=<YOUR_MT_FEED_TAG> --env MT_MAX_SESSIONS=<YOUR_MT_MAX_SESSIONS> --env MT_SESSION_TTL_MS=<YOUR_MT_SESSION_TTL_MS> --env MT_SERVICE_TTL_MS=<YOUR_MT_SERVICE_TTL_MS> -- npx -y @mfukushim/map-traveler-mcp

Related MCP servers

Scrapling MCP Server

Active

Give your AI agent stealth web scraping with Cloudflare bypass and CSS selection, powered by Scrapling.

67k
Python
BSD-3-Clause
View repository →

Chrome DevTools MCP

Active

Give your AI coding agent full control of a live Chrome browser for automation, debugging, and performance analysis.

45k
TypeScript
Apache-2.0
View repository →

com.puter/mcp-server

Active

Let AI agents manage your Puter files, websites, and serverless workers over MCP.

43k
TypeScript
AGPL-3.0
View repository →

io.github.bytedance/mcp-server-browser

Active

Browser automation for AI agents via MCP, powering ByteDance's Agent TARS hybrid GUI/DOM browser control.

37k
TypeScript
Apache-2.0
View repository →

io.github.bytedance/mcp-server-commands

Active

Run arbitrary shell commands from an MCP-connected AI agent.

37k
TypeScript
Apache-2.0
View repository →

io.github.bytedance/mcp-server-filesystem

Active

Filesystem access MCP server from ByteDance's UI-TARS/Agent TARS ecosystem.

37k
TypeScript
Apache-2.0
View repository →
io.github.mfukushim/map-traveler-mcp MCP Server | PluginBench