Virtual Traveling bot environment for MCP

产品定位

map-traveler-mcp 是一个为虚拟旅行机器人创建环境的 MCP 服务器，允许用户在 Google 地图上进行虚拟旅行，并通过 MCP 客户端与虚拟角色互动。

核心功能

1. 虚拟旅行控制：
2. 设置虚拟角色的当前位置和目的地
3. 开始和停止旅行

4. 获取旅行进度和当前位置信息

5. 图像生成：

6. 生成虚拟角色的头像

7. 将虚拟角色合成到旅行照片中

8. 社交媒体互动：

9. 获取和发布 Bluesky SNS 文章

10. 回复和点赞社交媒体帖子

11. 旅行信息获取：

12. 获取当前位置的街景照片
13. 获取附近设施信息

适用场景

1. 虚拟旅行体验
2. 社交媒体内容创作
3. 游戏化旅行应用
4. 教育和地理学习工具

工具列表

1. get_traveler_view_info：获取当前旅行角色的位置信息，包括照片和附近设施
2. get_traveler_location：获取当前旅行角色的地址和附近设施信息
3. set_traveler_location：设置旅行角色的当前位置
4. set_traveler_destination_address：设置旅行目的地的地址
5. start_traveler_journey：开始旅行
6. stop_traveler_journey：停止旅行
7. set_avatar_prompt：设置旅行角色图像生成的提示词
8. get_sns_feeds：获取 Bluesky SNS 文章
9. post_sns_writer：在 Bluesky SNS 上发布文章
10. reply_sns_writer：回复 Bluesky SNS 上的文章

常见问题解答

1. API 密钥设置：需要获取并设置多个 API 的访问密钥，包括 Google 地图和图像生成 API
2. 图像生成问题：需要安装 python 3.7-3.11 和 rembg cli
3. 社交媒体集成：建议为自动发布创建专用账户
4. 性能问题：在低性能 PC 上可能运行不稳定

使用教程

使用依赖

1. 安装 Node.js 22
2. 设置 Claude Desktop 以使用该服务

安装教程

1. 设置 claude_desktop_config.json 文件
2. 重启 Claude Desktop
3. 使用 "Where are you now?" 和 "Go on a journey." 开始对话

调试方式

1. 确保 API 密钥正确设置
2. 检查 rembg cli 是否正确安装
3. 查看日志以排查问题

完整功能设置

1. 获取 Google Map API 访问密钥并设置权限
2. 设置 SQLite 数据库路径
3. 安装 python 3.7-3.11 和 rembg cli
4. 获取图像生成 API 密钥
5. 设置 Bluesky SNS 账户信息

使用 ComfyUI

1. 配置 ComfyUI 以 API 模式运行
2. 设置服务器 URL 和详细配置值
3. 使用默认工作流或自定义工作流

使用 libreChat

1. 安装并配置 libreChat
2. 添加 rembg 容器
3. 将 map-traveler-mcp 添加到 MCP 服务
4. 使用 Agents 功能配置工具
5. 输入附加脚本以替代 MCP 资源功能

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。