Map Traveler MCP Server

Virtual traveler library for MCP

Local serverstdioPython

What is the Map Traveler MCP MCP server?

Map Traveler MCP becomes available to MCP clients through the map traveler mcp mcp server. Virtual traveler library for MCP.

What Map Traveler MCP does

This is an MCP server that creates an environment for an avatar to virtually travel on Google Maps.

Tools it exposes

Once connected, the assistant can call these 6 tools directly:

  • includePhoto — Gets nearby Google Street View photos. If you have set up an image generation AI, it will synthesize the avatar
  • includeNearbyFacilities — Gets information about nearby facilities
  • address — Address information (exact address, or general name that Google Maps or Claude can recognize, etc.)
  • settings — Setting information such as name and personality
  • prompt — reset_avatar_prompt
  • message — article

Installing the map traveler mcp mcp server

The server is distributed via npm as @mfukushim/map-traveler-mcp, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.

Configuration

Before the server will start you need to supply 8 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. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

AI-service servers chain other models into your assistant, turning a single chat into a small production pipeline. Map Traveler MCP sits in that group, and the shape of its toolset — includePhoto, includeNearbyFacilities, address among others — tells you what it is really for. Worth comparing against the other ai services servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • Maintained by mfukushim, written in Python.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the map traveler mcp mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
includePhotoGets nearby Google Street View photos. If you have set up an image generation AI, it will synthesize the avatar.
includeNearbyFacilitiesGets information about nearby facilities.
addressAddress information (exact address, or general name that Google Maps or Claude can recognize, etc.)
settingsSetting information such as name and personality.
promptreset_avatar_prompt
messagearticle

How to install the Map Traveler MCP MCP server

{
  "mcpServers": {
    "map-traveler": {
      "command": "npx",
      "args": ["-y", "@mfukushim/map-traveler-mcp"],
      "env": {
        "MT_GOOGLE_MAP_KEY": "your-value",
        "MT_GEMINI_IMAGE_KEY": "your-value",
        "MT_MAX_RETRY_GEMINI": "your-value",
        "MT_AVATAR_IMAGE_URI": "your-value",
        "MT_MAP_API_URL": "your-value",
        "MT_TIME_SCALE": "your-value",
        "MT_SQLITE_PATH": "your-value",
        "MT_TURSO_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
MT_GOOGLE_MAP_KEYCredential the server authenticates with.Yes
MT_GEMINI_IMAGE_KEYCredential the server authenticates with.Yes
MT_MAX_RETRY_GEMINIConfiguration value read at startup.Optional
MT_AVATAR_IMAGE_URIConfiguration value read at startup.Optional
MT_MAP_API_URLEndpoint or connection string the server talks to.Yes
MT_TIME_SCALEConfiguration value read at startup.Optional
MT_SQLITE_PATHFilesystem location the server is allowed to use.Optional
MT_TURSO_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Map Traveler MCP to includePhoto.
  • Use Map Traveler MCP to includeNearbyFacilities.
  • Use Map Traveler MCP to address.

Frequently asked questions

It connects Map Traveler MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (includePhoto, includeNearbyFacilities, address, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Map Traveler MCP directly.