mfukushim avatar

Mfukushim Map Traveler Mcp

mfukushim/map-traveler-mcp

You get an avatar that travels Google Maps while Claude narrates the journey. The server wraps Google Maps Direction and Street View APIs, letting you set destinations, query the traveler's current location, and grab nearby photos. Optionally wire up Gemini or PixAI to composite your avatar into Street View images for immersive reporting. It includes role prompts that turn Claude into a travel blogger, and if you connect a Bluesky account, the traveler can post updates and reply to mentions. The carBattle prompt is a neat twist: a story driven game where you transport secret documents from Yokohama to Tokyo with generated scenes. Useful if you want to prototype location based narratives or test spatial reasoning without building your own Maps integration.

GitHub stars
23
tools
19
auth
Required
transport
HTTP
last updated
Sep 29, 2025

Tools

19 tools

Public tool metadata for what this MCP can expose to an agent.

get_traveler_view_infoGets information about the current travel avatar's location.

Gets information about the current travel avatar's location.

No parameter schema in public metadata yet.

get_traveler_locationGets information about the current travel avatar's address and nearby facilities.

Gets information about the current travel avatar's address and nearby facilities.

No parameter schema in public metadata yet.

reach_a_percentage_of_destinationReach a specified percentage of the destination (moveMode=skip only)

Reach a specified percentage of the destination (moveMode=skip only)

No parameter schema in public metadata yet.

set_traveler_locationSets the current travel avatar's location.

Sets the current travel avatar's location.

No parameter schema in public metadata yet.

get_traveler_destination_addressGet the destination of the travel avatar you set

Get the destination of the travel avatar you set

No parameter schema in public metadata yet.

set_traveler_destination_addressSet the destination of the travel avatar

Set the destination of the travel avatar

No parameter schema in public metadata yet.

start_traveler_journeyStart the journey at the destination.(moveMode=realtime only)

Start the journey at the destination.(moveMode=realtime only)

No parameter schema in public metadata yet.

stop_traveler_journeyStop the journey.(moveMode=realtime only)

Stop the journey.(moveMode=realtime only)

No parameter schema in public metadata yet.

set_traveler_infoSet the traveler's attributes. Set the traveler's personality that you want to change dynamically, such as name and personality.

Set the traveler's attributes. Set the traveler's personality that you want to change dynamically, such as name and personality.

No parameter schema in public metadata yet.

get_traveler_infoGet the traveler's attributes. Get the traveler's personality.

Get the traveler's attributes. Get the traveler's personality.

No parameter schema in public metadata yet.

set_avatar_promptSet the prompt when generating the travel avatar image.

Set the prompt when generating the travel avatar image.

No parameter schema in public metadata yet.

reset_avatar_promptReset avatar generation prompts to default.

Reset avatar generation prompts to default.

No parameter schema in public metadata yet.

get_sns_feedsGets Bluesky SNS articles for the specified custom feed (feeds containing a specific tag).

Gets Bluesky SNS articles for the specified custom feed (feeds containing a specific tag).

No parameter schema in public metadata yet.

get_sns_mentionsGets recent mentions (likes, replies) to Bluesky SNS posts that you made yourself.

Gets recent mentions (likes, replies) to Bluesky SNS posts that you made yourself.

No parameter schema in public metadata yet.

post_sns_writerPosts an article to Bluesky SNS with the specified custom feed.

Posts an article to Bluesky SNS with the specified custom feed.

No parameter schema in public metadata yet.

reply_sns_writerReply to the article with the specified id.

Reply to the article with the specified id.

No parameter schema in public metadata yet.

add_likeAdd a like to the specified post.

Add a like to the specified post.

No parameter schema in public metadata yet.

tipsGuides you on how to set up features that have not yet been set.

Guides you on how to set up features that have not yet been set.

No parameter schema in public metadata yet.

get_settingGet environment and image settings.

Get environment and image settings.

No parameter schema in public metadata yet.

Sponsors

Readme

Virtual Traveling bot environment for MCP

We are currently developing a next-generation traveling bot system. It will take some time to complete, but in the meantime, please enjoy using this MCP server, which operates in MCP v1 mode.

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_5.png

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)


View the full README on GitHub

Details

Repository
github.com/mfukushim/map-traveler-mcp
Transport
HTTP
Auth
Required
Registry
MCP registry, active

More from mfukushim