Mfukushim Map Traveler MCP

What mfukushim-map-traveler-mcp MCP server does

mfukushim-map-traveler-mcp MCP server gives an MCP client a controllable avatar that travels through locations recognized by Google Maps. An agent can set the avatar’s current position, choose a destination, start or stop a real-time journey, or advance by a percentage when using skip mode. It can then inspect the current address, destination, nearby facilities, and travel progress.

Location reports can optionally include nearby Google Street View photos. When an image-generation service is configured, the server can also create a composite image featuring the travel avatar. The avatar has configurable attributes such as a name and personality, and its image-generation prompt can be changed or reset.

The project also includes optional Bluesky interactions. The available operations can read a configured custom feed, retrieve mentions of the bot’s posts, publish an entry, reply to a post, and add a like.

How it works

The server operates in MCP v1 mode and supports both stdio and Streamable HTTP. With stdio, an MCP client launches the package directly. Streamable HTTP can support multiple users, but the database API must be supplied per session through the Smithery configuration interface. The README notes that the older stdio setup should use version 0.0.81.

Five prompt resources are included. They configure Claude as a traveler, add Bluesky control, or provide sample scenarios such as a Yokohama-to-Tokyo document-transport game and Japan map challenges. The challenge examples require two Bluesky accounts and two Claude Desktop instances, and use skip mode; the README notes that this operation can be unstable.

Setup and configuration

Install the current package through an MCP client’s configuration, or use the older stdio command when compatibility with the previous release is needed. A Google Maps API key is needed for map-based operation. Image generation requires the relevant image service credentials and is subject to the provider’s charges.

The configuration supports Google Maps, Gemini image generation, SQLite or Turso storage, Bluesky credentials, and several image-generation backends. Supported image options listed by the project include Gemini, PixAI, Stability AI, ComfyUI, and rembg-related settings. Optional values control retry counts, avatar references, travel time scaling, map endpoints, image composition, and fixed prompts.

For Streamable HTTP, configure the database API for each session through Smithery. API usage may incur charges, so review each provider’s pricing before enabling map, social, or image features.

Tools and capabilities

The mfukushim-map-traveler-mcp MCP server exposes tools for:

• Reading the avatar’s location, destination, traveler details, and settings.
• Setting the current location and destination.
• Starting and stopping real-time journeys.
• Advancing a skip-mode journey to a selected percentage.
• Retrieving nearby facilities and optional Street View or generated images.
• Updating or resetting the avatar image prompt.
• Reading Bluesky feeds and mentions.
• Publishing, replying to, and liking Bluesky posts.
• Displaying setup guidance through the tips tool.

Limitations and notes

The project is still under development and currently uses MCP v1 mode. The mfukushim-map-traveler-mcp MCP server depends on external APIs and credentials, and some of those services can create usage charges. Image generation is optional rather than inherent to map traversal. Smithery’s version excludes images because they are heavy to run. The README also identifies the two-agent map challenge as somewhat unstable.