get_traveler_view_infoLABSCO SUMMARY
A traveller that actually takes time to arrive, and sends photos on the way.
What makes it more than a map lookup is that movement is bound to real roads and real durations, divided down by MT_TIME_SCALE — tell it to leave for Tokyo Station and it is en route, so "where are you now?" has a different answer each time you ask. The photographs are real Street View; the avatar composited into them is generated, and the project forces an anime style on purpose so the pictures cannot pass as genuine.
What it is
An environment for a virtual traveller. Give it a destination and it moves along real roads at a scaled-down pace, reporting where it is with Street View photography — optionally with a generated avatar composited into the shot, and optionally posting the trip to Bluesky.
What you get
- The traveller's current location, its address, and the facilities near it
- A Street View photo of where it stands, with the avatar composited in when image generation is configured
- A destination set by exact address or by a name Google Maps recognises, and a journey started and stopped along real roads
- Two movement modes: realtime, where the trip takes scaled real travel time, and skip, where you jump to a percentage of the way there
- The traveller's name and personality set and read back, and the avatar's generation prompt changed or reset to default
- Bluesky posting, replying and liking, plus reading the custom feed and your own mentions
- Five ready-made prompts as MCP resources: a plain traveller role, an SNS-aware one, a document-courier story, and two AI-versus-AI landscape challenges
- A tips tool that says which features are still unconfigured, and a settings read-out
Requirements
Node.js 22, launched with npx @mfukushim/map-traveler-mcp over stdio — or as Streamable HTTP, where per-session settings ride in a base64 config query parameter. A practice mode runs with no keys at all. For real travel, MT_GOOGLE_MAP_KEY with Street View Static, Places (New), Time Zone and Directions enabled on it; those calls are billable. Image generation is optional and pluggable: MT_GEMINI_IMAGE_KEY is the recommended route because its semantic mask composites without a background remover, while the pixAI, Stability.ai and ComfyUI paths also need the rembg CLI with Python 3.7 to 3.11. State lives in SQLite — MT_SQLITE_PATH locally, or MT_TURSO_URL with MT_TURSO_TOKEN remotely. Bluesky is optional and posts on its own, so give it a dedicated account through MT_BS_ID, MT_BS_PASS and MT_BS_HANDLE. MT_TIME_SCALE, default 4, sets how much faster than reality the travel runs, and MT_FILTER_TOOLS trims the tool list.
Setup effort
One command — npx -y @mfukushim/map-traveler-mcp
USE CASES
01
Sending it somewhere and following along
Set the destination by name, start the journey, then ask where it is and get the Street View photo back.
02
Playing a whole trip out in one sitting
Use skip mode and jump to a percentage of the way there rather than waiting out the scaled duration.
03
Giving the traveller a character
Set its name and personality, and the prompt its avatar image is generated from.
04
Running it as a travelogue account
Post the journey to Bluesky under the feed tag, then read the mentions it gets and reply.
05
Trying it before paying for any API
Run in practice mode, then ask what each unconfigured feature would need before you enable it.
19 tools
Listed in project docs. Your client may show a different list.
get_traveler_locationreach_a_percentage_of_destinationset_traveler_locationget_traveler_destination_addressset_traveler_destination_addressstart_traveler_journeystop_traveler_journeyset_traveler_infoget_traveler_infoset_avatar_promptreset_avatar_promptget_sns_feedsget_sns_mentionspost_sns_writerreply_sns_writeradd_liketipsget_settingBEFORE YOU INSTALL
What to know first
Tools you get
19 tools named in the project's documentation.
Requires
npx on PATH
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @mfukushim/map-traveler-mcpMCP Clients
Claude Desktop — no API keys
CLAUDE DESKTOP — NO API KEYS · JSON
{
"mcpServers": {
"traveler": {
"command": "npx",
"args": [
"-y",
"@mfukushim/map-traveler-mcp"
]
}
}
}Claude Desktop — API keys
CLAUDE DESKTOP — API KEYS · JSON
{
"mcpServers": {
"traveler": {
"command": "npx",
"args": [
"-y",
"@mfukushim/map-traveler-mcp"
],
"env": {
"MT_GOOGLE_MAP_KEY": "(Google Map API key)",
"MT_GEMINI_IMAGE_KEY": "(Gemini Image Api key)",
"MT_SQLITE_PATH": "(db save path: e.g. %USERPROFILE%/Desktop/traveler.sqlite ,$HOME/traveler.sqlite )",
"MT_BS_ID": "(Bluesky sns registration address)",
"MT_BS_PASS": "(bluesky sns password)",
"MT_BS_HANDLE": "(bluesky sns handle name: e.g. <YOUR_SUBDOMAIN>.bsky.social )",
"MT_MOVE_MODE": "(Option: Specify whether the movement mode is realtime or skip. default realtime)"
}
}
}
}LibreChat
LIBRECHAT · YAML
mcpServers:
traveler:
type: stdio
command: npx
args:
- -y
- "@mfukushim/map-traveler-mcp"
