MM

mfukushim/map-traveler-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

24 stars 9 forks 품질 72 트렌드 14MIT

MCP를 위한 가상 여행자 도서관

개요

우리는 현재 봇 시스템을 여행하는 차세대를 개발하고 있습니다. 완료하는 데 몇 시간이 걸릴 것입니다, 그러나 한편,이 MCP 서버를 사용하여 즐길 수, MCP v1 모드에서 작동. 이 MCP 서버는 Google지도에서 사실상 여행에 avatar 환경을 만듭니다. Claude Desktop과 같은 MCP 클라이언트에서 avatar에 대한 지침을 제공하고 사진과 여행의 진행 상황을보고 할 수 있습니다. MCP Registry 지원 준비 https://blog.modelcontextprotocol.io/posts/2025-09-08-mcp-registry-preview/ 여행 이미지 생성에 gemini-2.5-flash-image-previewnano-banana) 추가 nano-banana에 대한 지원이 추가되었습니다. Nano-banana의 semantic 가면은 remBg를 놓지 않고 짧은 시간에 합성 여행 이미지를 생성할 수 있습니다. 기존 이미지 합성은 여전히 가능하지만, Gemini nano-banana를 사용하는 것이 좋습니다. Streamable-HTTP 및 stdio 모두 지원 ( Smithery와 호환).

개요(AI 번역)

우리는 현재 봇 시스템을 여행하는 차세대를 개발하고 있습니다. 완료하는 데 몇 시간이 걸릴 것입니다, 그러나 한편,이 MCP 서버를 사용하여 즐길 수, MCP v1 모드에서 작동.

한국어 / 일본어

이 MCP 서버는 Google지도에서 사실상 여행에 avatar 환경을 만듭니다.

Claude Desktop과 같은 MCP 클라이언트에서 avatar에 대한 지침을 제공하고 사진과 여행의 진행 상황을보고 할 수 있습니다.

MCP Registry 지원 준비 https://blog.modelcontextprotocol.io/posts/2025-09-08-mcp-registry-preview/

여행 이미지 생성에 gemini-2.5-flash-image-preview (nano-banana) 추가

nano-banana에 대한 지원이 추가되었습니다. Nano-banana의 semantic 가면은 remBg를 놓지 않고 짧은 시간에 합성 여행 이미지를 생성할 수 있습니다. 기존 이미지 합성은 여전히 가능하지만, Gemini nano-banana를 사용하는 것이 좋습니다.

Streamable-HTTP 및 stdio 모두 지원 ( Smithery.ai의 설정 인터페이스와 호환)

그것은 전에 stdio 유형 MCP로, 또는 Streamable-HTTP로 사용될 수 있습니다. 여러 사용자를 지원하지만 데이터베이스 API는 Smithery를 사용하여 세션 당 지정해야합니다. ai 설정 인터페이스.

이 페이지는 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: …