MCP的虚拟旅行机器人环境

![Verified on MseeP](https://mseep.ai/app/073d88cc-277d-40b6-8c20-bcabf6c275e9) ](https://smithery.ai/server/@mfukushim/map-traveler-mcp)

英语/ 日语

这是一个MCP服务器，它为化身创建了一个在谷歌地图上虚拟旅行的环境。

从Claude Desktop等MCP客户端，您可以向化身发出指令，并用照片报告其旅程的进展。

为MCP注册表支持做准备https://blog.modelcontextprotocol.io/posts/2025-09-08-mcp-registry-preview/

在旅行图像生成中添加了gemini-2.5-flash图像预览（纳米香蕉）

添加了对纳米香蕉的支持。Nano banana的语义掩码允许您在短时间内生成合成旅行图像，而无需设置remBg。\ 虽然传统的图像合成仍然是可能的，但我们建议使用Gemini纳米香蕉。

支持流式HTTP和stdio（符合Smithery.ai的配置接口）

它可以像以前一样用作stdio类型的MCP，也可以用作流式HTTP。\ 尽管它支持多个用户，但必须使用Smithery.ai配置接口为每个会话指定数据库API。\ 由于它支持Streamable HTTP和stdio，因此预计它将与之前的MCP客户端一样工作，但如果您使用之前的stdio版本，请使用v0.0.x（v0.0.81）。\ npx -y @mfukushim/map-traveler-mcp@0.0.81

现在支持librechathttps://www.librechat.ai/.

现在支持Smitheryhttps://smithery.ai/server/@mfukushim/map-traveler mcp（图像被排除在外，因为它们运行起来很重）。

现已验证MseePhttps://mseep.ai/app/mfukushim-map-traveler-mcp

函数

MCP服务器工具功能

以下功能可用作MCP服务器。可用功能因设置和执行状态而异。

您可以直接指定函数名，但Claude LLM会自动识别它，因此您可以用一般术语指定操作。

例子： “你现在在哪里？”“我们去东京站吧。”

get_travel_view_info（includePhoto:布尔值，includeEarbyFacilities：布尔值）\

获取有关当前旅行头像位置的信息。 - includePhoto:获取附近的谷歌街景照片。如果你已经设置了一个图像生成AI，它将合成化身。 - includeEarbyFacilities：获取附近设施的信息。

get_travel_rocation（）\

获取有关当前旅行头像地址和附近设施的信息。

到达目的地的百分比（）

到达目标的指定百分比（moveMode=仅跳过） timeElapsed百分比：到达目的地的进度百分比（0~100）

set_traveler_location（地址：字符串）\

设置当前旅行头像的位置。 - 地址：地址信息（确切地址，或谷歌地图或克劳德可以识别的通用名称等）

获取旅行目的地地址\

获取您设置的旅行头像的目的地

set_traveler_destination_address（地址：字符串）\

设置旅行头像的目的地 - 地址：地址信息（确切地址，或谷歌地图或克劳德可以识别的通用名称等）

开始_旅行_旅程\

从目的地开始旅程。（moveMode=仅实时）

停止_旅行_旅程\

停止旅程。（moveMode=仅实时）

set_traveler_info（设置：字符串）\

设置旅行者的属性。设置您想要动态更改的旅行者的个性，例如姓名和个性。但是，如果你使用角色脚本，脚本会更稳定。 - 设置：设置姓名和个性等信息。

获取旅行信息\

获取旅行者的属性。了解旅行者的个性。

set_avatar_prompt（提示：字符串）\

设置生成旅行头像图像时的提示。默认是动漫风格的女人。动漫风格是为了防止虚假图像。 - 提示

重置_增值_提示\

将头像生成提示重置为默认值。

get_sns_feeds\

获取指定自定义源（包含特定标记的源）的Bluesky SNS文章。

get_ns_mentions\

获取您最近对自己发布的Bluesky SNS帖子的提及（点赞、回复）。

post_sns_writer（消息：字符串）\

使用指定的自定义订阅源将文章发布到Bluesky SNS。设置一个特定的标签，以便确定帖子是由旅行机器人生成的。 - 消息：文章

reply_sns_writer（消息：字符串，id:字符串）\

使用指定的id回复文章。设置一个特定的标签，以便确定帖子是由旅行机器人生成的。 - 消息：回复 - id：要回复的帖子的id

add_like（id:string）\

为指定的帖子添加点赞。 - id：要点赞的帖子的id

提示\

指导您如何设置尚未设置的功能。

get_setting\

获取环境和图像设置。

MCP资源

有五个自定义提示示例。当您使用Claude Desktop导入提示时，Claude将充当旅行者。 SNS兼容版本在进行旅行对话的同时控制SNS输入和输出。

role.txt\

克劳德将扮演一名旅行者。

roleWithSns.txt\

克劳德将扮演一名旅行者。它还控制阅读和发布到SNS。

carBattle.txt\

这是一款小型小说游戏，讲述了从横滨到东京运输秘密文件的故事。场景是自动生成的。设置moveMode=跳过播放。

japanMapChallenge.txt、japanMap挑战者2.txt\

两个AI通过社交网络相互交流，并使用风景图像玩挑战游戏。\ 要玩，您需要两个Bluesky帐户和两个Claude桌面。同时设置moveMode=skip。（但是，操作有点不稳定。）\ japanMapChallenge2有一个挑战反射规则。

设置

您需要获取并设置多个API的访问密钥，例如访问多个谷歌地图和生成图像。使用API可能会产生费用。

与Claude Desktop一起使用的设置

claude_desktop_configure.json（stdio类型）

{
  "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://192.168.1.100:8188)",
        "MT_COMFY_WORKFLOW_T2I": "(Optional: Path to API workflow file when using text to image with ComfyUI. If not specified: assets/comfy/t2i_sample.json)",
        "MT_COMFY_WORKFLOW_I2I": "(Optional: Path of API workflow file when image to image in ComfyUI. If not specified: assets/comfy/i2i_sample.json)",
        "MT_COMFY_PARAMS": "(Optional: Variable values to send to the workflow via comfyUI API)",
        "MT_FIXED_MODEL_PROMPT": "(Optional: Fixed avatar generation prompt. You will no longer be able to change your avatar during conversations.)",
        "MT_BODY_AREA_RATIO": "(Optional: Acceptable avatar image area ratio. default 0.042)",
        "MT_BODY_HW_RATIO": "(Optional: Acceptable avatar image aspect ratios. default 1.5~2.3)",
        "MT_BODY_WINDOW_RATIO_W": "(Optional: Avatar composite window horizontal ratio. default 0.5)",
        "MT_BODY_WINDOW_RATIO_H": "(Optional: Avatar composite window aspect ratio. default 0.75)",
        "MT_BS_ID":"(Bluesky sns registration address)",
        "MT_BS_PASS":"(bluesky sns password)",
        "MT_BS_HANDLE":"(bluesky sns handle name: e.g. xxxxxxxx.bsky.social )",
        "MT_FILTER_TOOLS": "(Optional: Directly filter the tools to be used. All are available if not specified. e.g. tips,set_traveler_location)",
        "MT_MOVE_MODE": "(Option: Specify whether the movement mode is realtime or skip. default realtime)",
        "MT_IMAGE_WIDTH": "(Option: Output image width (pixels) Default is 512)",
        "MT_NO_IMAGE": "(Options: true = do not output image, not specified = output image if possible, default is not specified)",
        "MT_NO_AVATAR": "(Option: true = Output StreetView image as is without avatar superimposition. Not specified = Superimpose avatar image. Default is not specified.)",
        "MT_FEED_TAG": "(Optional: Specify the feed tag when posting to SNS (#required, 15 characters or more) Default is #geo_less_traveler)",
        "MT_MAX_SESSIONS": "(Maximum number of sessions when using Streamable-http)",
        "MT_SESSION_TTL_MS": "(Session TTL when using Streamable-http)",
        "MT_SERVICE_TTL_MS": "(Service TTL when using Streamable-http)"
      }
    }
  }
}

claude_desktop_config.json（可流式传输的http类型）\

上述MT_环境变量应设置为运行地图旅行者mcp web服务的服务器的环境变量。

{
  "mcpServers": {
    "traveler": {
      "type": "streamable-http",
      "url": "https://(mcp server address)/mcp?config=(base64 config json)"
    }
  }
}

base64配置json（Smithery.ai扩展）\ 通过将以下格式的json连接成一行字符串，将其转换为base64，并将其设置为（base64设置json），您可以覆盖每个用户会话的不同API和设置。\ 如果数据库没有设置base64-config-json，它将在整个服务中共享（旅行者的位置将在数据库中共享，并按一个人计算）。\ 一旦MCP身份验证机制变得更加清晰，我们计划重新考虑为每个会话分配单个UserId的操作。

{
  "MT_GOOGLE_MAP_KEY": "xxxyyyzzz",
  "MT_GEMINI_IMAGE_KEY": "xxyyzz",
  "MT_MAX_RETRY_GEMINI": "1",
  "MT_AVATAR_IMAGE_URI": "file:///C:/Users/xxxx/Desktop/avatar.png",
  "MT_TURSO_URL": "libsql://xxxyyyzzz",
  "MT_TURSO_TOKEN": "abcdabcd",
  "MT_BS_ID": "xyxyxyxyx",
  "MT_BS_PASS": "1234xyz",
  "MT_BS_HANDLE": "aabbccdd",
  "MT_FILTER_TOOLS": "tips,set_traveler_location",
  "MT_MOVE_MODE": "direct",
  "MT_FEED_TAG": "#abcdefgabcdefgabcdefg"
}

（所有json值都可以省略）\ ↓ （json文本拼接）

{"MT_GOOGLE_MAP_KEY": "xxxyyyzzz", "MT_GEMINI_IMAGE_KEY": "xxyyzz", "MT_MAX_RETRY_GEMINI": "1", "MT_TURSO_URL": "libsql://xxxyyyzzz", "MT_TURSO_TOKEN": "abcdabcd", "MT_BS_ID": "xyxyxyxyx", "MT_BS_PASS": "1234xyz", "MT_BS_HANDLE": "aabbccdd", "MT_FILTER_TOOLS": "tips,set_traveler_location", "MT_MOVE_MODE": "direct", "MT_FEED_TAG": "#abcdefgabcdefgabcdefg"}

↓ （将base64版本设置为config=）

eyJNVF9HT09HTEVfTUFQX0tFWSI6ICJ4eHh5eXl6enoiLCAiTVRfR0VNSU5JX0lNQUdFX0tFWSI6ICJ4eHl5enoiLCAiTVRfTUFYX1JFVFJZX0dFTUlOSSI6ICIxIiwgIk1UX1RVUlNPX1VSTCI6ICJsaWJzcWw6Ly94eHh5eXl6enoiLCAiTVRfVFVSU09fVE9LRU4iOiAiYWJjZGFiY2QiLCAiTVRfQlNfSUQiOiAieHl4eXh5eHl4IiwgIk1UX0JTX1BBU1MiOiAiMTIzNHh5eiIsICJNVF9CU19IQU5ETEUiOiAiYWFiYmNjZGQiLCAiTVRfRklMVEVSX1RPT0xTIjogInRpcHMsc2V0X3RyYXZlbGVyX2xvY2F0aW9uIiwgIk1UX01PVkVfTU9ERSI6ICJkaXJlY3QiLCAiTVRfRkVFRF9UQUciOiAiI2FiY2RlZmdhYmNkZWZnYWJjZGVmZyJ9

注意：环境变量已重命名为标准snake case。添加MT_前缀是因为它们可以与其他环境变量结合使用，例如在librechat中。旧名称仍可用于向后兼容性。

请为Google Map API设置以下三个凭据。

街景静态API
地点API（新增）
API时区
API指南

https://developers.google.com/maps/documentation/streetview/get-api-key

如果要使用图像生成AI，请设置pixAi_key或sd_key。您还需要在PC上安装python3.7~3.11，并安装rembg-cli（建议使用虚拟环境）。

https://platform.pixai.art/docs\ https://platform.stability.ai/docs/api-reference#tag/SDXL-1.0和SD1.6/操作/textToImage

bluesky SNS地址/密码是可选的。建议您创建一个专用帐户，因为它会自动发布。

https://bsky.app/

您也可以在实践模式下运行它，这不需要API密钥进行验证。

练习模式设置

claude_desktop_config json

{
  "mcpServers": {
    "traveler": {
      "command": "npx",
      "args": ["-y", "@mfukushim/map-traveler-mcp"]
    }
  }
}

如何使用

使用练习模式

安装nodejs 22。

设置Claude Desktop以供使用。

在claude_desktop_config.json中反映上述设置之一。

重新启动克劳德桌面。设置可能需要一些时间（如果发生错误，请尝试重新启动Claude Desktop。如果不起作用，请参阅下面的注释）。确保屏幕右下角出现以下标记。

问“你现在在哪里？”和“去旅行吧。”对话就会开始。使用API时，将显示一个确认屏幕，因此选择允许。

从MCP中选择“附加”，然后选择role.txt。

内置了一个旅行提示，所以可以随时与它交谈。

使用完整功能

获取Google Map API访问密钥，并设置Street View Static API、Places API（New）、Time Zone API和Directions API的权限。在claude_desktop_config.json的环境文件中设置此项，然后重新启动。

此时，旅行日志将基于真实地图。如果旅行图像没有叠加，也会输出。

确定一个不会干扰磁盘的路径，并将其设置在claude_desktop_config.json的env的sqlite_path中。（示例：%USERPROFILE%/台式机/traveler.sqlite$HOME/文档/traveler.shqlite等）

此时，您的旅行日志将被保存，即使您关闭了Claude Desktop，您也可以继续旅行。

安装python 3.7到3.11，并使用cli安装rembg。我们建议使用虚拟环境，如venv。

python3 -m venv venv
. venv/bin/activate or .\venv\Scripts\activate
pip install "rembg[cpu,cli]"

使用示例映像文件检查rembg-cli是否正常工作。输入一个有人的图像，如果该人在输出文件中被剪切，则可以。

rembg i source_image_file dest_image_file

rembg-cli将安装在python.exe位置，因此请获取路径。文件位置因操作系统和python安装状态而异，但在venv的情况下，它是您设置的目录上方的（虚拟环境名称）\\Scripts\\rembg.exe或（虚拟环境名）/bin/rembg。如果找不到，请使用文件搜索软件搜索路径。在claude_desktop_config.json中将该路径设置为env的rembg_path。（示例：“rembg_path”：“C:\\Users\\xxxx\\Documents\\rembg_venv\\venv\\Scripts\\rembg.exe”）
从pixAI或Stability.ai网站获取图像生成API密钥。在claude_desktop_config.json的环境文件中将密钥设置为pixAi_key或sd_key。

化身现在将叠加在旅行图像上。

获取bluesky SNS地址/密码和句柄名称。分别在claude_desktop_config.json的env中的bs_id、bs_pass和bs_handle中设置这些参数。

导入旅行知识提示roleWithSns.txt，向SNS报告旅行行为（它会自动以机器人的形式发布，因此我们建议分配一个专用帐户）

我们没有使用cli准备rembg，而是添加了一个设置，允许您将rembg作为服务API来处理。\ 如果配置了以下rembg服务，则可以通过在remBgUrl中设置URL来使用rembg。

https://github.com/danielgatis/rembg?tab=readme-ov文件#rembg-s

如果您使用Docker版本启动容器并访问它，安装程序很简单。

https://github.com/danielgatis/rembg?tab=readme-ov文件#作为docker使用

配置数据库使用Turso libsql API

如果您想使用云API Turso libsql(https://turso.tech/libsql)如果没有本地sqlite文件，请注册Turso并分配sqlite数据库（付费、免费层可用）。\ 此加载项将自动配置（迁移）数据库。\ MT_TURSO_URL=TURSO数据库URL\ MT_TURSO_TOKEN=TURSO数据库访问令牌

使用云API进行rembg

无论您使用何种方法，rembg的本地设置都很复杂，但我们为付费云rembg添加了设置(https://withoutbg.com/).

注意：有一个小的免费试用版，但请注意，这是一个商业API，相当昂贵（每张图片约0.1欧元）。

MT_REMBG_WO_KEY=没有标记访问令牌

使用外部ComfyUI时（适用于更高级的用户）

您还可以将本地ComfyUI用作图像生成服务器。您可以自己详细配置图像生成特性，以降低API成本。

然而，配置将非常复杂，图像生成可能需要更长的时间。

将ComfyUI配置为在API模式下运行。
在env中将服务器URL设置为comfy_URL。
以json字符串的形式设置详细的配置值，例如要在env中使用的模型。

例子。

{
  "env": {
    "comfy_url": "http://192.168.1.100:8188",
    "comfy_workflow_t2i": "C:\\Documents\\t2itest.json",
    "comfy_workflow_i2i":"C:\\Documents\\i2itest.json",
    "comfy_params":"ckpt_name='animagineXL40_v40.safetensors',denoise=0.65"
  }
}

默认工作流可以在包中使用assets/comfort/t2_sample.json和assets/comasy/i2i_sample.json。您可以使用%指定变量，并在comfy_params中指定变量。

使用 libreChat

它已被改编为与libreChat一起使用。这使得它更容易使用，但需要一些额外的设置。\ 此外，除非您使用的PC具有良好的性能水平，例如可以稳定运行Docker，否则它似乎不会稳定。

安装免费聊天

请确保它按照官方网站上的描述工作。\ 在这种情况下，由于需要额外的设置，我们建议使用Docker配置。

https://www.librechat.ai/docs/local/docker

使用官方过程配置librechat.yaml。\ 我认为您需要添加本地或API LLM服务。

https://www.librechat.ai/docs/configuration/librechat_yaml

添加登录用户。

https://www.librechat.ai/docs/configuration/authentication#create-用户脚本

请设置它，以便您可以进行常规聊天对话。

添加具有其他设置的rembg容器

要在Docker中使用rembg，请添加拉取和运行rembg Docker容器。

docker-compositeoverride.yml

 services:
   api:
     volumes:
       - type: bind
         source: ./librechat.yaml
         target: /app/librechat.yaml

   rembg:
     image: danielgatis/rembg:latest
     restart: always
     command: "s --host 0.0.0.0 --port 7000 --log_level info"

将地图旅行者mcp添加到mcp服务中

添加librechat.yaml

mcpServers:
  traveler:
    type: stdio
    command: npx
    args:
      - -y
      - "@mfukushim/map-traveler-mcp"

添加.env（与claude_desktop_config.json中的env相同）

# map-traveler-mcp
GoogleMapApi_key=(Google Map API key)
sqlite_path=/home/run_test.sqlite (e.g. librechat in an unobtrusive location inside the container, or in an external directory that you don't want to mount.)
remBgUrl=http://rembg:7000 (rembg Service API URL, container URL)
(Other settings such as image generation AI settings, PixAI key, stability.ai API key, ComfyUI settings, etc.)

设置后，重新启动容器。\ 在速度较慢的PC上，mcp初始化可能会失败。多次重启可能有效，但这可能很难运行。..

书Chat settings

要使用libreChat中的MCP函数，请使用代理函数。

在对话屏幕上，选择代理。\

从屏幕右侧的面板中选择Agent Builder并配置您的代理。\

选择“添加工具”以使用地图漫游器。\

将出现代理工具屏幕，因此选择并添加所有地图旅行者mcp工具（如果地图旅行者mcp工具未列出，则mcp初始化失败，因此请重新启动容器或通过检查日志等查看设置）\

在说明区域中输入其他脚本。\

由于libreChat没有MCP资源功能，请在指令区域中输入以下URL的内容文本。\ https://github.com/mfukushim/map-traveler-mcp/blob/main/assets/scenario/role.txt\

单击“创建”按钮保存代理。\

开始新的聊天。

史密瑟里

请参考https://smithery.ai/server/@mfukushim/地图旅行者mcp。\ 支持远程MCP（流式http模式）。图像生成仅在nano-banna上可用。\ 现在可以使用Turso-sqlite记录数据库设置，因此如果您配置了Turso，您的旅行进度也将被保存。\

安装指南（日语，但有很多照片）

介绍与实践模式\

https://note.com/marble_walkers/n/n7a8f79e4fb30

数据库，谷歌地图API，图像生成API\

https://note.com/marble_walkers/n/n765257c27f3b

头像提示\

https://note.com/marble_walkers/n/nc7273724faea

SNS集成\

https://note.com/marble_walkers/n/na7c956befe7b

应用程序1\

https://note.com/marble_walkers/n/n3c86edd8e817

ComfyUI API\

https://note.com/marble_walkers/n/ncefc7c05d102

应用程序2\

https://note.com/marble_walkers/n/ne7584ed231c8

LibreChat设置\

https://note.com/marble_walkers/n/n339bf7905324

AI Agent SNS战斗地图挑战赛\

https://note.com/marble_walkers/n/n6db937573eaa

支持Smithery、Turso libSQL和rembg API\

https://note.com/marble_walkers/n/ne3b3c0f99707

流式HTTP支持\

https://note.com/marble_walkers/n/n030063f22dc0

纳米香蕉支架\

https://note.com/marble_walkers/n/n5d49514dddec

关于源代码的更多信息

我使用Effect.ts来简化错误管理和学习。\ 我们也使用效果服务，但由于MCP调用的工作方式，我们认为使用该服务整合它不是最佳选择。\ 我认为直接在Effect中处理MCP呼叫会更简单。\ 附录：我知道我可以重新考虑如何使用效果服务并整齐地重写它，但我仍在考虑是否重写它。

Map Traveler MCP

快速接入

详细介绍