home / mcp / virtual traveling bot mcp server

Virtual Traveling Bot MCP Server

Virtual traveler library for MCP

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "mfukushim-map-traveler-mcp": {
      "url": "https://(mcp server address)/mcp?config=(base64 config json)",
      "headers": {
        "MT_BS_ID": "username.bsky.social",
        "MT_SD_KEY": "sk-...",
        "MT_BS_PASS": "mypassword",
        "MT_FEED_TAG": "#travel_mcp",
        "MT_NO_IMAGE": "true",
        "MT_BS_HANDLE": "@handle",
        "MT_COMFY_URL": "http://localhost:8188",
        "MT_MOVE_MODE": "realtime",
        "MT_PIXAI_KEY": "sk-...",
        "MT_TURSO_URL": "libsql://...",
        "MT_IMAGE_WIDTH": "512",
        "MT_TURSO_TOKEN": "abcd1234",
        "MT_REMBG_WO_KEY": "your_token",
        "MT_GOOGLE_MAP_KEY": "REPLACE_WITH_YOUR_KEY",
        "MT_AVATAR_IMAGE_URI": "file:///path/to/avatar.png",
        "MT_GEMINI_IMAGE_KEY": "REPLACE_WITH_YOUR_KEY",
        "MT_MAX_RETRY_GEMINI": "1"
      }
    }
  }
}

You can run a dedicated MCP server that creates a virtual traveling avatar on Google Maps, control its journey from an MCP client, and receive progress updates with images. This setup supports both local (stdio) and remote (HTTP) MCP configurations, image generation options, and SNS integration for reporting travel activity.

How to use

From your MCP client, such as Claude Desktop, you can instruct the travel avatar and monitor its progress. You can start a journey toward a destination, fetch current location details, and request travel images and nearby facilities. Use practice mode first to get comfortable with the flow, then switch to the full feature mode with real map data and image generation enabled.

How to install

Prerequisites: install Node.js and a compatible Python environment for optional image processing.

# Install Node.js 22 or newer
# Then install Claude Desktop and configure it for MCP use as directed by your environment

Additional sections

The MCP server supports two connection methods: a remote HTTP (Streamable-HTTP) endpoint and a local stdio-based runner. Both are described below with explicit commands that you can copy and adapt.

Note: You will need API keys for Google Maps services and any image generation or SNS services you choose to use. Set these in the environment for the MCP server and restart the client if needed.

### HTTP MCP connection (remote)
{
  "type": "http",
  "name": "traveler_http",
  "url": "https://(mcp server address)/mcp?config=(base64 config json)",
  "args": []
}

### STDIO MCP connection (local)
{
  "type": "stdio",
  "name": "traveler_stdio",
  "command": "npx",
  "args": ["-y", "@mfukushim/map-traveler-mcp"]
}

The stdio setup above uses the npx command to run the MCP server locally. You may also configure additional environment variables if you want to customize how the traveler behaves or where it stores data.

Configuration and notes

Important environment variables (examples shown; replace placeholders with real values): MT_GOOGLE_MAP_KEY, MT_GEMINI_IMAGE_KEY, MT_MAX_RETRY_GEMINI, MT_AVATAR_IMAGE_URI, MT_TURSO_URL, MT_TURSO_TOKEN, MT_BS_ID, MT_BS_PASS, MT_BS_HANDLE, MT_MOVE_MODE, MT_FEED_TAG, MT_NO_IMAGE, MT_IMAGE_WIDTH, MT_REMBG_WO_KEY, MT_REMBG_URL, MT_REMBG_PATH, MT_PIXAI_KEY, MT_SD_KEY, MT_COMFY_URL, MT_COMFY_WORKFLOW_T2I, MT_COMFY_WORKFLOW_I2I, MT_COMFY_PARAMS.

Tools and capabilities

The MCP server exposes a variety of traveler-related actions. You can query the avatar’s current location, set a destination, start or stop the journey, adjust avatar attributes, and interact with SNS feeds. You can also generate and customize avatar prompts for image synthesis and manage travel reports.

Available tools

get_traveler_view_info

Fetch current location and nearby facilities; optionally include photos generated by image AI.

get_traveler_location

Retrieve the travel avatar's current address and nearby facilities.

reach_a_percentage_of_destination

Advance the journey to a specified percentage of completion.

set_traveler_location

Update the avatar's current location by address or recognizable place name.

get_traveler_destination_address

Get the set destination address.

set_traveler_destination_address

Set a new destination address for the traveler.

start_traveler_journey

Begin moving toward the destination in realtime mode.

stop_traveler_journey

Pause movement toward the destination in realtime mode.

set_traveler_info

Adjust traveler attributes such as name and personality; role scripts offer stability.

get_traveler_info

Retrieve traveler attributes and personality.

set_avatar_prompt

Set the prompt used to generate the travel avatar image.

reset_avatar_prompt

Reset avatar generation prompts to defaults.

get_sns_feeds

Fetch Bluesky posts from a custom travel feed.

get_sns_mentions

Get recent mentions of your Bluesky posts.

post_sns_writer

Post a Bluesky article from the travel bot with a specific tag.

reply_sns_writer

Reply to a Bluesky post with a travel bot tag.

add_like

Like a Bluesky post by id.

tips

Guidance for enabling features not yet configured.

get_setting

Retrieve environment and image settings.