MM

mfukushim/map-traveler-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

24 stars 9 forks 品質 72 トレンド 14MIT

MCP の仮想旅行者ライブラリ

概要

現在、次世代の走行ボットシステムを開発中です。 MCP v1 モードで動作するこの MCP サーバーを利用してください。 これは、Googleマップ上で実質的に旅行するためのアバターのための環境を作成するMCPサーバーです。 Claude Desktop などの MCP クライアントから、アバターに指示を与え、写真での旅の進捗を報告することができます。 MCPレジストリサポートの準備 [[T0] 旅行画像生成にgeini-2.5-flash-image-preview(nano-banana)を追加 ナノバナナのサポートを追加しました。 Nano-banana のセマンティックマスクは、remBg を設定せずに短時間でコンポジット旅行画像を生成できます。 従来の画像合成は可能ですが、Gemini nano-bananaの使用をお勧めします。 Streamable-HTTP と stdio の両方をサポート(Smithery との互換性).

概要(AI 翻訳)

現在、次世代の走行ボットシステムを開発中です。 MCP v1 モードで動作するこの MCP サーバーを利用してください。

English / 日本語

これは、Googleマップ上で実質的に旅行するためのアバターのための環境を作成するMCPサーバーです。

Claude Desktop などの MCP クライアントから、アバターに指示を与え、写真での旅の進捗を報告することができます。

MCPレジストリサポートの準備 https://blog.modelcontextprotocol.io/posts/2025-09-08-mcp-registry-preview/

旅行イメージ生成にgemini-2.5-flash-image-preview(nano-banana)を追加

ナノバナナのサポートを追加しました。 Nano-banana のセマンティックマスクは、remBg を設定せずに短時間でコンポジット旅行画像を生成できます。 従来の画像合成は可能ですが、Gemini nano-bananaの使用をお勧めします。

Streamable-HTTP と stdio の両方をサポート(Smisery.ai の config インターフェイスとの互換性)

stdio-type の MCP として、または Streamable-HTTP として使用できます。 複数のユーザーをサポートしていますが、Smithery を使用してセッションごとにデータベース API を指定しなければなりません。 ai config インターフェイス.

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

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.
GitHub で README 全文を見る

インストール

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