An MCP server that creates a virtual travel environment using Google Maps and Street View. Allows avatars to travel virtually with image generation and social media integration for travel progress reports.

Installation

NPX

npx -y @mfukushim/map-traveler-mcp

NPX (v0.0.81 stdio)

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

Configuration

Claude Desktop (stdio type)

{
  "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)"
      }
    }
  }
}

Claude Desktop (streamable-http type)

{
  "mcpServers": {
    "traveler": {
      "type": "streamable-http",
      "url": "https://(mcp server address)/mcp?config=(base64 config json)"
    }
  }
}

Practice Mode

{
  "mcpServers": {
    "traveler": {
      "command": "npx",
      "args": ["-y", "@mfukushim/map-traveler-mcp"]
    }
  }
}

Available Tools

Tool	Description
get_traveler_view_info	Gets information about the traveler avatar's current location with optional photos and nearby points of interest...
get_traveler_location	Gets information about the traveler avatar's current address and nearby points of interest
reach_a_percentage_of_destination	Reach a specified percentage of the destination (moveMode=skip only)
set_traveler_location	Sets the traveler avatar's current location
get_traveler_destination_address	Get the traveler avatar's destination address that you have set
set_traveler_destination_address	Set the traveler avatar's destination address
start_traveler_journey	Start a journey to the destination (moveMode=realtime only)
stop_traveler_journey	Stop the journey (moveMode=realtime only)
set_traveler_info	Set traveler attributes such as name and personality
get_traveler_info	Get traveler attributes and personality
set_avatar_prompt	Set the prompt for generating the traveler avatar's image
reset_avatar_prompt	Reset avatar generation prompts to default values
get_sns_feeds	Gets Bluesky SNS posts for a specified user feed
get_sns_mentions	Gets recent mentions (likes, replies) to Bluesky SNS posts
post_sns_writer	Posts an article to Bluesky SNS with a specified user feed

Features

• Virtual travel along Google Maps with avatar simulation
• Integration with Google Street View photos with avatar composition
• Support for multiple image generation APIs (Gemini, PixAI, Stability.ai, ComfyUI)
• Bluesky SNS integration for travel reports and social interaction
• Support for both stdio and streamable-HTTP MCP protocols
• Real-time and skip travel modes
• Multi-user support with session management
• Custom prompt resources for various travel scenarios
• Support for nano-banana semantic masks for accelerated image generation
• Nearby points of interest search and location information

Environment Variables

Required

• MT_GOOGLE_MAP_KEY - Google Map API key

Optional

• MT_GEMINI_IMAGE_KEY - Gemini Image API key
• MT_MAX_RETRY_GEMINI - Number of retry attempts for Gemini image generation (Default: 0)
• MT_AVATAR_IMAGE_URI - Character reference image URI for Gemini image generation
• MT_SQLITE_PATH - Database save path
• MT_TURSO_URL - Turso sqlite API URL
• MT_TURSO_TOKEN - Turso sqlite API access token
• MT_PIXAI_KEY - PixAI API key
• MT_SD_KEY - Stability.ai API key for image generation

Usage Examples

Where are you now?

Let's head to Tokyo Station.

Start traveling.

Begin the journey to the destination.

Show me photos of the current location.

Notes

Requires Google Maps API with Street View Static API, Places API (New), Time Zone API, and Directions API permissions. Supports practice mode without API keys. Includes custom prompt resources for role-playing scenarios. Compatible with LibreChat, Smithery.ai, and MseeP platforms.