DragonMCP 是一个为 AI Agent 设计的 Model Context Protocol（MCP）服务器，目标是为中国内地、中国香港及亚洲地区的本地生活服务提供接口。
用途与定位 它让 AI Agent 能够获取香港与中国内地边境地区真实、可验证的公开数据。项目方强调，服务器中每个工具都调用实时在线 API，没有模拟数据；若上游数据源不可用，工具会明确报告不可用，而不会编造看似合理的答案。用户可通过内置的 system_run_selftest 工具随时检测各上游是否可达。
主要能力
- 香港地铁（MTR）实时到站：无需 API Key，覆盖全部10条线路——港岛线、荃湾线、观塘线、将军澳线、东铁线（延伸至罗湖与落马洲）、屯马线、南港岛线、东涌线、机场快线、迪士尼线；站名支持英文或中文输入。
- 香港天文台天气：无需 API Key，包含生效中的天气警告。
- 高德地图相关工具：需要用户自备 AMAP_API_KEY，仅覆盖中国内地。
使用方式 前置条件为 Node.js >= 18。香港相关工具无需 .env 文件；使用高德工具时，复制模板并填入自己的密钥。接入 Claude Desktop 时，在 claude_desktop_config.json 中添加配置；如需中国内地工具，再添加 "env": { "AMAP_API_KEY": "your_key" }。也可以在 stdio 模式下运行，stdin/stdout 承载 MCP JSON-RPC，诊断信息走 stderr 以保持协议流干净。项目计划发布至 npm，使 npx dragon-mcp 无需克隆、无需密钥即可使用。
限制（官方明确列出）
- 路线规划以最少换乘为目标，而非最短耗时；由于没有公开站间运行时间，优化的是可测量的换乘次数，因此偶尔会出现两次换乘路线比一次换乘更快的例外。
- 实时到站仅覆盖上车段；缺少运行时间，无法推算到达换乘站的时间，因此不为后续路段提供到站信息。
- 有两个车站没有实时数据源：天后与太子。途经它们的路线规划可用，但到站信息会报告为不可用，而非伪造。
- 高德工具需自备密钥，且仅覆盖中国内地。
- 跨境行程规划尚未实现；东铁线可到达边境车站，但完整拼接香港→深圳行程仍在路线图第二阶段。
架构与路线图 第一阶段：来源可溯与零配置——每个工具响应携带 source、fetched_at、freshness；发布到 npm；每日 CI 自检并提供状态徽章。第二阶段：跨境——MTR 换乘规划、边境口岸、广深港高铁、机场快线整合，以及一次调用跨越边界两侧的 plan_cross_border_trip。第三阶段：覆盖更多 data.gov.hk 来源（巴士/渡轮 ETA、台风信号、空气质量）。
项目原则 不接受模拟工具：返回伪造数据的工具比缺失工具更糟，因为 Agent 无法分辨区别。若上游 API 不可用，正确的做法是不注册该工具。
许可与致谢 项目采用 MIT 许可，详见 LICENSE。致谢 Anthropic（Model Context Protocol）、港铁公司与 data.gov.hk（开放实时交通 API）、香港天文台（开放天气 API）、高德（地图与路线）。
