MM

mfukushim/map-traveler-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

24 stars 9 forks Качество 72 Тренд 14MIT

Виртуальная библиотека для путешественников MCP

Обзор

В настоящее время мы разрабатываем систему передвижных ботов следующего поколения. Это займет некоторое время, но в то же время, пожалуйста, воспользуйтесь этим сервером MCP, который работает в режиме MCP v1. Это MCP-сервер, который создает среду для виртуального путешествия аватара по картам Google. От клиента MCP, такого как Claude Desktop, вы можете дать инструкции аватару и сообщить о ходе его путешествия с фотографиями. Подготовка к поддержке реестра MCP[0] Добавлен gemini-2.5-flash-image-preview (нано-банан) для создания изображений путешествий Добавлена поддержка нанобанана. Семантическая маска Nano-banana позволяет создавать сложные изображения путешествий за короткое время без настройки remBg. Хотя обычный синтез изображений все еще возможен, мы рекомендуем использовать нанобанан Близнецов. Поддерживает Streamable-HTTP и stdio (совместим с Smithery).

Обзор (машинный перевод)

В настоящее время мы разрабатываем систему передвижных ботов следующего поколения. Это займет некоторое время, но в то же время, пожалуйста, воспользуйтесь этим сервером MCP, который работает в режиме MCP v1.

Английский/японский

Это MCP-сервер, который создает среду для виртуального путешествия аватара по картам Google.

От клиента MCP, такого как Claude Desktop, вы можете дать инструкции аватару и сообщить о ходе его путешествия с фотографиями.

Подготовка к поддержке реестра MCP https://blog.modelcontextprotocol.io/posts/2025-09-08-mcp-registry-preview/

Добавлено gemini-2.5-flash-image-preview (нано-банан) для генерации изображений путешествий

Добавлена поддержка нанобанана. Семантическая маска Nano-banana позволяет создавать сложные изображения путешествий за короткое время без настройки remBg. Хотя обычный синтез изображений все еще возможен, мы рекомендуем использовать нанобанан Близнецов.

Поддержка Streamable-HTTP и stdio (совместим с интерфейсом конфигурирования Smithery.ai)

Его можно использовать как MCP стрим-типа, как и раньше, или как Streamable-HTTP. Несмотря на то, что он поддерживает несколько пользователей, API базы данных должен быть указан за сеанс с помощью Smithery. Конфигурационный интерфейс.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального 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.

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/[email protected]

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.
Открыть полный README на GitHub

Установка

npx -y @mfukushim/map-traveler-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "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: …