shield_lock
JinDaGe
← Back to MCP directory
publicPublicdnsLocal runtime

Map Traveler

一个基于MCP服务器的虚拟旅行机器人环境，让用户通过Google Maps进行虚拟旅行并与AI旅行者互动。

article

README

🚀 虚拟旅行指南

本虚拟旅行指南为你提供虚拟旅行相关的实践模式、技术设置、应用操作等多方面的详细指引，助你开启精彩的虚拟旅行体验。

🚀 快速开始

你可以根据以下不同主题的链接，深入了解虚拟旅行的各个方面：

  1. 虚拟旅行简介与实践模式：点击查看
  2. 数据库、Google Map API、图像生成API设置：点击查看
  3. 角色提示语训练：点击查看
  4. 社交媒体（Bluesky）集成指南：点击查看
  5. 应用程序1操作说明：点击查看
  6. ComfyUI API使用教程：点击查看
  7. 应用程序2功能详解：点击查看
  8. LibreChat配置指南：点击查看

⚠️ 注意事项

⚠️ 重要提示

  • 我们使用Effect.ts来简化错误处理流程，同时为了学习目的而采用。
  • 由于MCP调用方式的特殊性，我们没有采用服务化的方式来整合这些功能。

🆕 最新更新说明

  1. 新增了图像宽度设置项，默认值为512。将此值设为更小的数值可能有助于降低LLM API调用成本。
  2. 添加了一个环境变量配置，用于禁止未具备图像输入/输出能力的MCP客户端生成或输出任何图像。具体设置如下：
{
  "env": {
    "MT_NO_IMAGE": "true"
  }
}
或者
{
  "env": {
    "GoogleMapApi_key": "xxxx",
    "MT_NO_IMAGE": "true"
  }
}
  1. 在发布到Bluesky的社交信息中新增了标签功能。要求标签必须至少15个字符，且不能为空。若未指定，默认使用"#geo_less_traveler"。
  2. 对从SNS获取的信息格式进行了微调，并相应调整了发布的消息内容结构。
  3. 新增了一个允许多个旅行机器人通过SNS进行群聊互动的脚本。
READY-TO-PASTE CONFIG

MCP client config generator

Choose your client, fill the required environment variables, then copy a config generated from this server's published metadata

terminal
Environment variableslockValues stay in this browser tab and are not uploaded or saved
Claude Desktop
{
  "mcpServers": {
    "traveler": {
      "command": "npx",
      "args": [
        "-y",
        "@mfukushim/map-traveler-mcp"
      ],
      "env": {
        "MT_GOOGLE_MAP_KEY": "(Google Map API key)",
        "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_REMBG_PATH": "(absolute path of the installed rembg cli)",
        "MT_REMBG_URL": "(rembg API URL)",
        "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_FEED_TAG": "(Optional: Specify the feed tag when posting to SNS (#required, 15 characters or more) Default is #geo_less_traveler)"
      }
    }
  }
}
Save toclaude_desktop_config.json
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client