Back to MCP Servers
🧩

map-traveler-mcp

API key required

Virtual traveler library for MCP

To add map-traveler-mcp to Claude, run the install command below or copy the ready-made config for Claude Code, Claude Desktop, Cursor and VS Code further down. Restart your client after adding it and its tools show up in your next conversation. It needs 36 environment variables, listed below.

DevTools

Install

npx -y @mfukushim/map-traveler-mcp@0.1.4

Environment variables

MT_GOOGLE_MAP_KEYSet in your MCP config
MT_GEMINI_IMAGE_KEYSet in your MCP config
MT_MAX_RETRY_GEMINISet in your MCP config
MT_AVATAR_IMAGE_URISet in your MCP config
MT_MAP_API_URLSet in your MCP config
MT_TIME_SCALESet in your MCP config
MT_SQLITE_PATHSet in your MCP config
MT_TURSO_URLSet in your MCP config
MT_TURSO_TOKENSet in your MCP config
MT_REMBG_PATHSet in your MCP config
MT_REMBG_URLSet in your MCP config
MT_REMBG_WO_KEYSet in your MCP config
MT_PIXAI_KEYSet in your MCP config
MT_SD_KEYSet in your MCP config
MT_PIXAI_MODEL_IDSet in your MCP config
MT_COMFY_URLSet in your MCP config
MT_COMFY_WORKFLOW_T2ISet in your MCP config
MT_COMFY_WORKFLOW_I2ISet in your MCP config
MT_COMFY_PARAMSSet in your MCP config
MT_FIXED_MODEL_PROMPTSet in your MCP config
MT_BODY_AREA_RATIOSet in your MCP config
MT_BODY_HW_RATIOSet in your MCP config
MT_BODY_WINDOW_RATIO_WSet in your MCP config
MT_BODY_WINDOW_RATIO_HSet in your MCP config
MT_BS_IDSet in your MCP config
MT_BS_PASSSet in your MCP config
MT_BS_HANDLESet in your MCP config
MT_FILTER_TOOLSSet in your MCP config
MT_MOVE_MODESet in your MCP config
MT_IMAGE_WIDTHSet in your MCP config
MT_NO_IMAGESet in your MCP config
MT_NO_AVATARSet in your MCP config
MT_FEED_TAGSet in your MCP config
MT_MAX_SESSIONSSet in your MCP config
MT_SESSION_TTL_MSSet in your MCP config
MT_SERVICE_TTL_MSSet in your MCP config

Install with your client

Terminal
claude mcp add map-traveler --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@0.1.4

Run this in a terminal to add the server to Claude Code.

What this does

map-traveler-mcp exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.

Requirements

This server needs the following environment variables to be set before it can run:

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

Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).

Frequently asked questions

How do I install map-traveler-mcp?

Run the Claude Code command in the install section to add map-traveler-mcp to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.

Which clients work with map-traveler-mcp?

This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to map-traveler-mcp as well.

Does map-traveler-mcp need an API key?

Yes. Before it can run, set these 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. They go in the env block of your MCP config.

Imported from the Official MCP Registry. The details above come from the registry entry; the maker can claim this listing to correct them, add docs, and see its traffic.

Is this your MCP server?

Claim this listing to see its traffic, fix details yourself, and skip the review queue on future updates.

Listed on clauderules.net

Add this badge to your README

Show visitors this server is listed in the ClaudeRules directory. The badge links straight to this listing.

Markdown
[![Listed on clauderules.net](https://clauderules.net/api/badge/ai-smithery-mfukushim-map-traveler-mcp)](https://clauderules.net/mcp/ai-smithery-mfukushim-map-traveler-mcp)
HTML
<a href="https://clauderules.net/mcp/ai-smithery-mfukushim-map-traveler-mcp" target="_blank" rel="noopener noreferrer"><img src="https://clauderules.net/api/badge/ai-smithery-mfukushim-map-traveler-mcp" alt="Listed on clauderules.net" /></a>