Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"traveler": {
"env": {
"MT_BS_ID": "(Bluesky sns registration address)",
"MT_SD_KEY": "(or Stability.ai image generation API key",
"MT_BS_PASS": "(bluesky sns password)",
"MT_FEED_TAG": "(Optional: Specify the feed tag when posting to SNS (#required, 15 characters or more) Default is #geo_less_traveler)",
"MT_NO_IMAGE": "(Options: true = do not output image, not specified = output image if possible, default is not specified)",
"MT_BS_HANDLE": "(bluesky sns handle name: e.g. xxxxxxxx.bsky.social )",
"MT_COMFY_URL": "(Option: Generate image using ComfyUI API at specified URL. Example: http://192.168.1.100:8188)",
"MT_MOVE_MODE": "(Option: Specify whether the movement mode is realtime or skip. default realtime)",
"MT_NO_AVATAR": "(Option: true = Output StreetView image as is without avatar superimposition. Not specified = Superimpose avatar image. Default is not specified.)",
"MT_PIXAI_KEY": "(pixAi API key)",
"MT_REMBG_URL": "(rembg API URL)",
"MT_TURSO_URL": "(Turso sqlite API URL)",
"MT_REMBG_PATH": "(absolute path of the installed rembg cli)",
"MT_TIME_SCALE": "(Optional:Scale of travel time on real roads duration. default 4)",
"MT_IMAGE_WIDTH": "(Option: Output image width (pixels) Default is 512)",
"MT_MAP_API_URL": "(Optional: Map API custom endpoint. Example: direction=https://xxxx,places=https://yyyy )",
"MT_SQLITE_PATH": "(db save path: e.g. %USERPROFILE%/Desktop/traveler.sqlite ,$HOME/traveler.sqlite )",
"MT_TURSO_TOKEN": "(Turso sqlite API access token)",
"MT_COMFY_PARAMS": "(Optional: Variable values to send to the workflow via comfyUI API)",
"MT_FILTER_TOOLS": "(Optional: Directly filter the tools to be used. All are available if not specified. e.g. tips,set_traveler_location)",
"MT_MAX_SESSIONS": "(Maximum number of sessions when using Streamable-http)",
"MT_REMBG_WO_KEY": "(withoutbg.com rembg API key)",
"MT_BODY_HW_RATIO": "(Optional: Acceptable avatar image aspect ratios. default 1.5~2.3)",
"MT_GOOGLE_MAP_KEY": "(Google Map API key)",
"MT_PIXAI_MODEL_ID": "(Optional: pixAi ModelId, if not set use default model 1648918127446573124 ",
"MT_SERVICE_TTL_MS": "(Service TTL when using Streamable-http)",
"MT_SESSION_TTL_MS": "(Session TTL when using Streamable-http)",
"MT_BODY_AREA_RATIO": "(Optional: Acceptable avatar image area ratio. default 0.042)",
"MT_AVATAR_IMAGE_URI": "(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_GEMINI_IMAGE_KEY": "(Gemini Image Api key)",
"MT_MAX_RETRY_GEMINI": "(Number of retries when generating Gemini images Default: 0)",
"MT_COMFY_WORKFLOW_I2I": "(Optional: Path of API workflow file when image to image in ComfyUI. If not specified: assets/comfy/i2i_sample.json)",
"MT_COMFY_WORKFLOW_T2I": "(Optional: Path to API workflow file when using text to image with ComfyUI. If not specified: assets/comfy/t2i_sample.json)",
"MT_FIXED_MODEL_PROMPT": "(Optional: Fixed avatar generation prompt. You will no longer be able to change your avatar during conversations.)",
"MT_BODY_WINDOW_RATIO_H": "(Optional: Avatar composite window aspect ratio. default 0.75)",
"MT_BODY_WINDOW_RATIO_W": "(Optional: Avatar composite window horizontal ratio. default 0.5)"
},
"args": [
"-y",
"@mfukushim/map-traveler-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
This is an MCP server that creates an environment for an avatar to virtually travel on Google Maps.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@mfukushim/map-traveler-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked @mfukushim/map-traveler-mcp against OSV.dev.
Click any tool to inspect its schema.
role.txtClaude will act as a traveler.
role.txt
roleWithSns.txtClaude will act as a traveler. It also controls reading and posting to SNS.
roleWithSns.txt
carBattle.txtA small novel game about a story of transporting secret documents from Yokohama to Tokyo. Scenes are automatically generated. Set moveMode=skip to play.
carBattle.txt
japanMapChallenge.txtTwo AIs communicate with each other via SNS and play a challenge game using landscape images.
japanMapChallenge.txt
japanMapChallenge2.txtTwo AIs communicate with each other via SNS and play a challenge game using landscape images with a challenge reflection rule.
japanMapChallenge2.txt
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in maps / entertainment
The official MCP Server for the Mux API
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
A Model Context Protocol (MCP) server that gives Claude direct control over Strudel.cc for AI-assisted music generation and live coding.
Real-time BART departures, trip planning, fares, stations, and advisories.
MCP Security Weekly
Get CVE alerts and security updates for Virtual traveler library for MCP and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
English / Japanese
This is an MCP server that creates an environment for an avatar to virtually travel on Google Maps.
From an MCP client such as Claude Desktop, you can give instructions to the avatar and report on the progress of its journey with photos.
Preparing for MCP Registry Support https://blog.modelcontextprotocol.io/posts/2025-09-08-mcp-registry-preview/
Added gemini-2.5-flash-image-preview (nano-banana) to travel image generation
Support for nano-banana has been added. Nano-banana's semantic mask allows you to generate composite travel images in a short time without setting remBg.
Although conventional image synthesis is still possible, we recommend using Gemini nano-banana.
Supports both Streamable-HTTP and stdio (compliant with Smithery.ai's config interface)
It can be used as a stdio-type MCP as before, or as Streamable-HTTP.
Although it supports multiple users, the database API must be specified per session using the Smithery.ai config interface.
Since it supports both Streamable-HTTP and stdio, it is expected to work as is with the previous MCP client, but if you use the previous stdio version, please use v0.0.x (v0.0.81).
npx -y @mfukushim/map-traveler-mcp@0.0.81
Now supports librechat https://www.librechat.ai/.
Now supports Smithery https://smithery.ai/server/@mfukushim/map-traveler-mcp (images are excluded because they are heavy to run).
Now verified MseeP https://mseep.ai/app/mfukushim-map-traveler-mcp
The following functions can be used as an MCP server. The available functions vary depending on the settings and execution state.
You can specify the function name directly, but Claude LLM will automatically recognize it, so you can specify the operation in general terms.
Example: "Where are you now?" "Let's leave for Tokyo Station."