io.github.mfukushim/map-traveler-mcp

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

Quality Score

/100

Virtual traveler library for MCP

Repository →

§01 Install

Claude Desktop (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": "<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": "<your-mt_turso_token>",
        "MT_REMBG_PATH": "<mt_rembg_path>",
        "MT_REMBG_URL": "<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": "<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": "<your-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 (.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": "<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": "<your-mt_turso_token>",
        "MT_REMBG_PATH": "<mt_rembg_path>",
        "MT_REMBG_URL": "<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": "<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": "<your-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>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y @mfukushim/map-traveler-mcp

§02 Environment variables

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

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Maps & Location

ai.geodesiclabs/governance-platform

Deterministic AI governance platform. Validates agent outputs, discovers patterns, solves math.

ai.jeda/jeda-ai

Visual AI for strategic thinking — SWOT, flowcharts, mindmaps, Gantt diagrams as polished SVG.

Squad

ai.meetsquad/squad

Your AI Product Manager. Surface insights, build roadmaps, and plan strategy with 30+ tools.