{"type":"mcp_server","name":"map-traveler-mcp","description":"This repository provides an MCP server for a virtual travel avatar on Google Maps, allowing users to instruct the avatar and receive progress updates with photos, even supporting platforms like LibreChat.","category":"AI","language":"TypeScript","stars":23,"forks":0,"owner":"mfukushim","github_url":"https://github.com/mfukushim/map-traveler-mcp","homepage":"https://akibakokoubou.jp/","setup":"## Setup\n\n#### Settings for using with Claude Desktop\n1.  Set the following three Credentials for Google Map API: Street View Static API, Places API (New), Time Zone API, and Directions API.\n2.  If you want to use the image generation AI, set either pixAi_key or sd_key, install python3.7~3.11, and install rembg cli (virtual environment recommended).\n3.  The bluesky SNS address/password are optional; creating a dedicated account is recommended.\n\n#### Practice mode settings\n1. Install nodejs 22.\n2. Set up Claude Desktop for use.\n3. Reflect the practice mode settings in claude_desktop_config.json.\n4. Restart Claude Desktop.\n\n#### Use the full feature\n1. Get a Google Map API access key and set the permissions for Street View Static API, Places API (New), Time Zone API, and Directions API, then set this in the env of claude_desktop_config.json and restart.\n2. Decide on a path that will not interfere with the disk and set it in the sqlite_path of the env of claude_desktop_config.json.\n3. Install python 3.7 to 3.11 and install rembg with cli, using a virtual environment such as venv is recommended.\n4. Get the path to rembg cli and set that path to rembg_path of env in claude_desktop_config.json.\n5. Get an image generation API key from the pixAI or Stability.ai site and set the key to pixAi_key or sd_key in env of claude_desktop_config.json.\n6. Get the bluesky SNS address/password and handle name, then set these in bs_id, bs_pass, and bs_handle in env of claude_desktop_config.json, respectively.\n\n#### When using external ComfyUI (for more advanced users)\n1. Configure ComfyUI to run in API mode.\n2. Set the server URL to comfy_url in env.\n3. Set detailed configuration values such as the model to be used in env in the form of a json string.\n\n#### Using libreChat\n1. Install libreChat using Docker configuration.\n2. Configure librechat.yaml, adding a local or API LLM service.\n3. Add a user for login.\n4. Add a rembg container with additional settings in docker-compose.override.yml.\n5. Add map-traveler-mcp to the MCP service in librechat.yaml and .env.\n6. Restart the container.\n7. Configure the Agents function in libreChat, adding all the map-traveler-mcp tools.\n8. Enter additional script in the instruction area by copying the content text of role.txt from the GitHub repository.\n9. Save the agent and start a new chat.","tools":"## Available Tools\n\n1.  `get_traveler_view_info(includePhoto:boolean,includeNearbyFacilities:boolean)` (Gets information about the current travel avatar's location.)\n2.  `get_traveler_location()` (Gets information about the current travel avatar's address and nearby facilities.)\n3.  `reach_a_percentage_of_destination()` (Reach a specified percentage of the destination (moveMode=skip only))\n4.  `set_traveler_location(address: string)` (Sets the current travel avatar's location.)\n5.  `get_traveler_destination_address` (Get the destination of the travel avatar you set)\n6.  `set_traveler_destination_address(address: string)` (Set the destination of the travel avatar)\n7.  `start_traveler_journey` (Start the journey at the destination.(moveMode=realtime only))\n8.  `stop_traveler_journey` (Stop the journey.(moveMode=realtime only))\n9.  `set_traveler_info(settings:string)` (Set the traveler's attributes.)\n10. `get_traveler_info` (Get the traveler's attributes.)\n11. `set_avatar_prompt(prompt:string)` (Set the prompt when generating the travel avatar image.)\n12. `reset_avatar_prompt` (Reset avatar generation prompts to default.)\n13. `get_sns_feeds` (Gets Bluesky SNS articles for the specified custom feed.)\n14. `get_sns_mentions` (Gets recent mentions (likes, replies) to Bluesky SNS posts that you made yourself.)\n15. `post_sns_writer(message:string)` (Posts an article to Bluesky SNS with the specified custom feed.)\n16. `reply_sns_writer(message:string,id:string)` (Reply to the article with the specified id.)\n17. `add_like(id:string)` (Add a like to the specified post.)\n18. `tips` (Guides you on how to set up features that have not yet been set.)\n19. `get_setting` (Get environment and image settings.)","faq":null,"created_at":"2025-01-03T01:09:53+00:00","updated_at":"2025-03-28T10:54:00+00:00","source_url":"https://model-context-protocol.com/servers/virtual-travel-avatar-google-maps-mcp","related_articles":[]}