Labsco
mfukushim logo

Map Traveler

★ 23

from mfukushim

A virtual travel environment for an avatar on Google Maps, utilizing various Google Maps and optional AI image generation APIs.

🔥🔥✓ VerifiedPaid serviceNeeds API keys
#email#automation#database#ai-image#devops#git#search#maps

Virtual Traveling bot environment for MCP

Verified on MseeP smithery badge

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.

<img alt="img_5.png" src="https://raw.githubusercontent.com/mfukushim/map-traveler-mcp/for_image/tools/img_5.png" width="400"/>

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

Functions

MCP server tools function

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."

  • get_traveler_view_info(includePhoto:boolean,includeNearbyFacilities:boolean)
    Gets information about the current travel avatar's location.
    • 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.
  • get_traveler_location()
    Gets information about the current travel avatar's address and nearby facilities.
  • reach_a_percentage_of_destination() Reach a specified percentage of the destination (moveMode=skip only) timeElapsedPercentage: Percent progress towards destination(0~100)
  • set_traveler_location(address: string)
    Sets the current travel avatar's location.
    • address: Address information (exact address, or general name that Google Maps or Claude can recognize, etc.)
  • get_traveler_destination_address
    Get the destination of the travel avatar you set
  • set_traveler_destination_address(address: string)
    Set the destination of the travel avatar
    • address: Address information (exact address, or general name that Google Maps or Claude can recognize, etc.)
  • start_traveler_journey
    Start the journey at the destination.(moveMode=realtime only)
  • stop_traveler_journey
    Stop the journey.(moveMode=realtime only)
  • set_traveler_info(settings:string)
    Set the traveler's attributes. Set the traveler's personality that you want to change dynamically, such as name and personality. However, if you use a role script, the script is more stable.
    • settings: Setting information such as name and personality.
  • get_traveler_info
    Get the traveler's attributes. Get the traveler's personality.
  • set_avatar_prompt(prompt:string)
    Set the prompt when generating the travel avatar image. The default is an anime-style woman. The anime style is enforced to prevent fake images.
    • prompt
  • reset_avatar_prompt
    Reset avatar generation prompts to default.
  • get_sns_feeds
    Gets Bluesky SNS articles for the specified custom feed (feeds containing a specific tag).
  • get_sns_mentions
    Gets recent mentions (likes, replies) to Bluesky SNS posts that you made yourself.
  • post_sns_writer(message:string)
    Posts an article to Bluesky SNS with the specified custom feed. Set a specific tag so that it can be determined that the post was generated by the travel bot.
    • message: article
  • reply_sns_writer(message:string,id:string)
    Reply to the article with the specified id. Set a specific tag so that it can be determined that the post was generated by the travel bot.
    • message: reply
    • id: The ID of the post to reply to
  • add_like(id:string)
    Add a like to the specified post.
    • id: The ID of the post to like
  • tips
    Guides you on how to set up features that have not yet been set.
  • get_setting
    Get environment and image settings.

MCP resources

Has five custom prompt samples. When you import a prompt with Claude Desktop, Claude will act as a traveler. The SNS-compatible version controls SNS input and output while having a travel conversation.

  • role.txt
    Claude will act as a traveler.

  • roleWithSns.txt
    Claude will act as a traveler. It also controls reading and posting to SNS.

  • carBattle.txt
    This is a small novel game about a story of transporting secret documents from Yokohama to Tokyo. Scenes are automatically generated. Set moveMode=skip to play.

  • japanMapChallenge.txt,japanMapChallenge2.txt
    Two AIs communicate with each other via SNS and play a challenge game using landscape images.
    To play, you need two Bluesky accounts and two Claude Desktops. Also set moveMode=skip. (However, the operation is somewhat unstable.)
    japanMapChallenge2 has a challenge reflection rule.

Setting

You will need to obtain and set access keys for multiple APIs, such as for accessing multiple Google maps and generating images. Use of the API may incur charges.

Settings for using with Claude Desktop

  • claude_desktop_config.json (stdio type)
Copy & paste — that's it
{
  "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_MAX_RETRY_GEMINI": "(Number of retries when generating Gemini images Default: 0)",
        "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_MAP_API_URL": "(Optional: Map API custom endpoint. Example: direction=https://xxxx,places=https://yyyy )",
        "MT_TIME_SCALE": "(Optional:Scale of travel time on real roads duration. default 4)",
        "MT_SQLITE_PATH":"(db save path: e.g. %USERPROFILE%/Desktop/traveler.sqlite ,$HOME/traveler.sqlite )",
        "MT_TURSO_URL":"(Turso sqlite API URL)",
        "MT_TURSO_TOKEN":"(Turso sqlite API access token)",
        "MT_REMBG_PATH": "(absolute path of the installed rembg cli)",
        "MT_REMBG_URL": "(rembg API URL)",
        "MT_REMBG_WO_KEY": "(withoutbg.com rembg API key)",
        "MT_PIXAI_KEY":"(pixAi API key)",
        "MT_SD_KEY":"(or Stability.ai image generation API key",
        "MT_PIXAI_MODEL_ID": "(Optional: pixAi ModelId, if not set use default model 1648918127446573124 ",
        "MT_COMFY_URL": "(Option: Generate image using ComfyUI API at specified URL. Example: http://192.168.1.100:8188)",
        "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_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_PARAMS": "(Optional: Variable values to send to the workflow via comfyUI API)",
        "MT_FIXED_MODEL_PROMPT": "(Optional: Fixed avatar generation prompt. You will no longer be able to change your avatar during conversations.)",
        "MT_BODY_AREA_RATIO": "(Optional: Acceptable avatar image area ratio. default 0.042)",
        "MT_BODY_HW_RATIO": "(Optional: Acceptable avatar image aspect ratios. default 1.5~2.3)",
        "MT_BODY_WINDOW_RATIO_W": "(Optional: Avatar composite window horizontal ratio. default 0.5)",
        "MT_BODY_WINDOW_RATIO_H": "(Optional: Avatar composite window aspect ratio. default 0.75)",
        "MT_BS_ID":"(Bluesky sns registration address)",
        "MT_BS_PASS":"(bluesky sns password)",
        "MT_BS_HANDLE":"(bluesky sns handle name: e.g. xxxxxxxx.bsky.social )",
        "MT_FILTER_TOOLS": "(Optional: Directly filter the tools to be used. All are available if not specified. e.g. tips,set_traveler_location)",
        "MT_MOVE_MODE": "(Option: Specify whether the movement mode is realtime or skip. default realtime)",
        "MT_IMAGE_WIDTH": "(Option: Output image width (pixels) Default is 512)",
        "MT_NO_IMAGE": "(Options: true = do not output image, not specified = output image if possible, default is not specified)",
        "MT_NO_AVATAR": "(Option: true = Output StreetView image as is without avatar superimposition. Not specified = Superimpose avatar image. Default is not specified.)",
        "MT_FEED_TAG": "(Optional: Specify the feed tag when posting to SNS (#required, 15 characters or more) Default is #geo_less_traveler)",
        "MT_MAX_SESSIONS": "(Maximum number of sessions when using Streamable-http)",
        "MT_SESSION_TTL_MS": "(Session TTL when using Streamable-http)",
        "MT_SERVICE_TTL_MS": "(Service TTL when using Streamable-http)"
      }
    }
  }
}
  • claude_desktop_config.json (streamable-http type)
    The above MT_ environment variables should be set as environment variables for the server that runs the map-traveler-mcp web service.
Copy & paste — that's it
{
  "mcpServers": {
    "traveler": {
      "type": "streamable-http",
      "url": "https://(mcp server address)/mcp?config=(base64 config json)"
    }
  }
}

base64 config json (Smithery.ai Expansion)
By concatenating the json in the following format into a single line of string, converting it to base64, and setting it as (base64 setting json), you can overwrite different APIs and settings for each user session.
If the database is not set base64 config json, it will be shared across the entire service (the location of the traveler will be shared across the database and counted for one person).
We plan to reconsider the operation of assigning an individual UserId for each session once the MCP authentication mechanism has become a little clearer.

Copy & paste — that's it
{
  "MT_GOOGLE_MAP_KEY": "xxxyyyzzz",
  "MT_GEMINI_IMAGE_KEY": "xxyyzz",
  "MT_MAX_RETRY_GEMINI": "1",
  "MT_AVATAR_IMAGE_URI": "file:///C:/Users/xxxx/Desktop/avatar.png",
  "MT_TURSO_URL": "libsql://xxxyyyzzz",
  "MT_TURSO_TOKEN": "abcdabcd",
  "MT_BS_ID": "xyxyxyxyx",
  "MT_BS_PASS": "1234xyz",
  "MT_BS_HANDLE": "aabbccdd",
  "MT_FILTER_TOOLS": "tips,set_traveler_location",
  "MT_MOVE_MODE": "direct",
  "MT_FEED_TAG": "#abcdefgabcdefgabcdefg"
}

(All json values can be omitted)
↓ (json text concatenation)

Copy & paste — that's it
{"MT_GOOGLE_MAP_KEY": "xxxyyyzzz", "MT_GEMINI_IMAGE_KEY": "xxyyzz", "MT_MAX_RETRY_GEMINI": "1", "MT_TURSO_URL": "libsql://xxxyyyzzz", "MT_TURSO_TOKEN": "abcdabcd", "MT_BS_ID": "xyxyxyxyx", "MT_BS_PASS": "1234xyz", "MT_BS_HANDLE": "aabbccdd", "MT_FILTER_TOOLS": "tips,set_traveler_location", "MT_MOVE_MODE": "direct", "MT_FEED_TAG": "#abcdefgabcdefgabcdefg"}

↓ (Set the base64 version to config=)

Copy & paste — that's it
eyJNVF9HT09HTEVfTUFQX0tFWSI6ICJ4eHh5eXl6enoiLCAiTVRfR0VNSU5JX0lNQUdFX0tFWSI6ICJ4eHl5enoiLCAiTVRfTUFYX1JFVFJZX0dFTUlOSSI6ICIxIiwgIk1UX1RVUlNPX1VSTCI6ICJsaWJzcWw6Ly94eHh5eXl6enoiLCAiTVRfVFVSU09fVE9LRU4iOiAiYWJjZGFiY2QiLCAiTVRfQlNfSUQiOiAieHl4eXh5eHl4IiwgIk1UX0JTX1BBU1MiOiAiMTIzNHh5eiIsICJNVF9CU19IQU5ETEUiOiAiYWFiYmNjZGQiLCAiTVRfRklMVEVSX1RPT0xTIjogInRpcHMsc2V0X3RyYXZlbGVyX2xvY2F0aW9uIiwgIk1UX01PVkVfTU9ERSI6ICJkaXJlY3QiLCAiTVRfRkVFRF9UQUciOiAiI2FiY2RlZmdhYmNkZWZnYWJjZGVmZyJ9

NOTE: The environment variables have been renamed to standard snake case. The MT_ prefix is added because they may be used in conjunction with other environment variables, such as in librechat. The old names can still be used for backward compatibility.

Please set the following three Credentials for Google Map API.

  • Street View Static API
  • Places API (New)
  • Time Zone API
  • Directions API

https://developers.google.com/maps/documentation/streetview/get-api-key

If you want to use the image generation AI, set either pixAi_key or sd_key. You also need to have python3.7~3.11 installed on your PC and rembg cli installed (virtual environment recommended).

https://platform.pixai.art/docs
https://platform.stability.ai/docs/api-reference#tag/SDXL-1.0-and-SD1.6/operation/textToImage

The bluesky SNS address/password are optional. It is recommended that you create a dedicated account as it will post automatically.

https://bsky.app/

You can also run it in practice mode, which does not require an API key for verification.

Practice mode settings

claude_desktop_config.json

Copy & paste — that's it
{
  "mcpServers": {
    "traveler": {
      "command": "npx",
      "args": ["-y", "@mfukushim/map-traveler-mcp"]
    }
  }
}

Using libreChat

It has been adapted to work with libreChat. This makes it easier to use, but some additional settings are required.
Also, it seems that it will not be stable unless the PC you use has a decent level of performance, such as one that can stably run Docker.

Install libreChat

Please make sure it works as described on the official website.
In this case, we recommend using Docker configuration due to additional settings.

https://www.librechat.ai/docs/local/docker

Configure librechat.yaml using the official procedure.
I think you will need to add a local or API LLM service.

https://www.librechat.ai/docs/configuration/librechat_yaml

Add a user for login.

https://www.librechat.ai/docs/configuration/authentication#create-user-script

Please set it so that you can have general chat conversations.

Add a rembg container with additional settings

To use rembg with Docker, add pulling and running the rembg Docker container.

docker-compose.override.yml

Copy & paste — that's it
 services:
   api:
     volumes:
       - type: bind
         source: ./librechat.yaml
         target: /app/librechat.yaml

   rembg:
     image: danielgatis/rembg:latest
     restart: always
     command: "s --host 0.0.0.0 --port 7000 --log_level info"

Add map-traveler-mcp to the MCP service

Add librechat.yaml

Copy & paste — that's it
mcpServers:
  traveler:
    type: stdio
    command: npx
    args:
      - -y
      - "@mfukushim/map-traveler-mcp"

Add .env (Same as env in claude_desktop_config.json)

Copy & paste — that's it
# map-traveler-mcp
GoogleMapApi_key=(Google Map API key)
sqlite_path=/home/run_test.sqlite (e.g. librechat in an unobtrusive location inside the container, or in an external directory that you don't want to mount.)
remBgUrl=http://rembg:7000 (rembg Service API URL, container URL)
(Other settings such as image generation AI settings, PixAI key, stability.ai API key, ComfyUI settings, etc.)

After setting, restart the container.
On slow PCs, mcp initialization may fail. Multiple restarts may work, but this may be difficult to run...

llibreChat settings

To use the MCP function in libreChat, use the Agents function.

  1. On the conversation screen, select Agents.
    <img alt="libre1.png" src="https://raw.githubusercontent.com/mfukushim/map-traveler-mcp/for_image/tools/libre1.png" width="200"/>
  2. Select Agent Builder from the panel on the right side of the screen and configure your agent.
    <img alt="libre2.png" src="https://raw.githubusercontent.com/mfukushim/map-traveler-mcp/for_image/tools/libre2.png" width="200"/>
  3. Select Add Tools to use map-traveler.
    <img alt="libre3.png" src="https://raw.githubusercontent.com/mfukushim/map-traveler-mcp/for_image/tools/libre3.png" width="200"/>
  4. The agent tools screen will appear, so select and add all the map-traveler-mcp tools (if the map-traveler-mcp tools are not listed, MCP initialization has failed, so please restart the container or review the settings by checking the logs, etc.)
    <img alt="libre4.png" src="https://raw.githubusercontent.com/mfukushim/map-traveler-mcp/for_image/tools/libre4.png" width="200"/>
    <img alt="libre5.png" src="https://raw.githubusercontent.com/mfukushim/map-traveler-mcp/for_image/tools/libre5.png" width="200"/>
  5. Enter additional script in the instruction area.
    Since libreChat does not have the MCP resource function, enter the content text of the following URL into the instruction area instead.
    https://github.com/mfukushim/map-traveler-mcp/blob/main/assets/scenario/role.txt
    <img alt="libre7.png" src="https://raw.githubusercontent.com/mfukushim/map-traveler-mcp/for_image/tools/libre7.png" width="200"/>
  6. Click the Create button to save the agent.
    <img alt="libre6.png" src="https://raw.githubusercontent.com/mfukushim/map-traveler-mcp/for_image/tools/libre6.png" width="200"/>
  7. Start a new chat.

Smithery

Please refer to https://smithery.ai/server/@mfukushim/map-traveler-mcp.
Remote MCP (Streamable-http mode) is supported. Image generation is only available on nano-banana.
Database settings can now be recorded with Turso sqlite, so if you configure Turso, your travel progress will also be saved.
<img alt="smithery.png" src="tools/smithery.png" width="400"/>