DragonMCP
中国本土生命代理人神经中心
英语 | 简体中文 | 日本语 | 韩语 | 法语 | 德语
让Claude/DeepSeek/Qwen直接点外卖、叫滴滴、查高铁票和支付水电费。
   ](https://nodejs.org/) 
______________________________________________________________________
🌟 什么是DragonMCP？
DragonMCP是一个模型上下文协议（MCP）服务器，旨在弥合人工智能代理和本地生命服务之间的差距 大中华区（中国大陆、香港）和亚洲.
它旨在解决人工智能代理和现实世界服务之间的“最后一英里”问题。
______________________________________________________________________
🔥 现场演示：港铁实时时刻表
我们已经实施了 港铁查询工具 作为我们的第一个MVP。人工智能代理现在可以直接从港铁开放API获取实时列车时刻表。
场景:
用户：“下一班从金钟到中环的火车是什么时候？”
代理响应:
“下一班从金钟开往中环（前往坚尼地城）的港岛线列车： - 到达时间：2分钟（10:30:00） - 后续列车：5分钟（10:33:00）”
*（通过将DragonMCP连接到您的MCP客户端来亲自尝试！）*
______________________________________________________________________
🛠️ 支持的服务（测试版）
我们正在积极扩大对当地服务的支持。以下是当前集成的接口（其中一些是用于开发的模拟/占位符）：
| 区域 | 类别 | 服务 | 工具名称 | 描述 | 状态 |
|---|---|---|---|---|---|
| 大中华地区 | 旅行 | 地铁（香港） | search_mtr_schedule | 实时列车时刻表（港岛线/荃湾线） | ✅ 现场直播 |
| 阿马普（高德） | amap_search_poi | 搜索POI（餐厅、酒店等） | ✅ 现场直播 | ||
| 阿马普（高德） | amap_walking_direction | 步行路线规划 | ✅ 现场直播 | ||
| 阿马普（高德） | amap_driving_direction | 行车路线规划（最快） | ✅ 现场直播 | ||
| 阿马普（高德） | amap_transit_direction | 公交线路规划（综合） | ✅ 现场直播 | ||
| 天气 | 香港天文台 | hk_weather_current | 香港最新天气报告 | ✅ 现场直播 | |
| 旅行 | 滴滴 | book_taxi_didi | 估算价格并预订行程 | 🚧 Mock | |
| 支付 | 微信支付 | wechat_pay_create | 创建付款单 | 🚧 Mock | |
| 支付宝 | alipay_pay_create | 创建付款单 | 🚧 Mock | ||
| 生活方式 | 消息 | meituan_search_food | 搜索送餐服务 | 🚧 Mock | |
| 购物 | 淘宝 | taobao_search_product | 搜索产品 | 🚧 Mock | |
| 亚洲扩张 | 旅行 | 抓斗（新加坡/东南亚） | book_ride_grab | 估算并预订行程 | 🚧 Mock |
| 导航地图（KR） | naver_map_search | 搜索韩国的景点🚧 Mock | |||
| 支付 | LINE Pay（日本/台湾） | line_pay_request | 请求付款 | 🚧 Mock |
______________________________________________________________________
⚠️ 安全与免责声明
重要：该项目包括支付（微信支付、支付宝）和叫车（滴滴）等敏感服务的模拟实现。
- 不要 在当前版本中使用真实的财务数据或个人凭据。
- 支付工具(
wechat_pay_create,alipay_pay_create)当前返回 假数据 仅用于演示目的。没有实际的资金转移。 - 将来集成真实API时，请确保遵循严格的安全协议（OAuth、HTTPS、令牌管理）。
______________________________________________________________________
🏗️ 建筑
DragonMCP充当AI代理和各种本地服务API之间的中间件。
graph TD
A[AI Agent Client] -->|MCP Protocol| B[DragonMCP Server]
B --> C[Service Router]
subgraph "Greater China Services"
C --> D["Payment (WeChat/Alipay)"]
C --> E["Travel (MTR/Amap/Didi)"]
C --> F["Lifestyle (Meituan/Taobao)"]
end
subgraph "Asia Expansion Services"
C --> G["Travel (Grab/Naver)"]
C --> H["Payment (LINE Pay/PayNow)"]
C --> I["Lifestyle (Rakuten/Kakao)"]
end
subgraph "External APIs"
D -.-> J[WeChat/Alipay API]
E -.-> K[MTR/Amap API]
G -.-> L[Grab/Naver API]
H -.-> M[LINE Pay API]
end架构细节记录在本README中，并将随着时间的推移在repo文档中扩展。
______________________________________________________________________
🗺️ 路线图和功能
第一阶段：MVP（当前）
- \[x\] 核心框架：Express+MCP SDK+TypeScript设置。
- \[x\] 旅行（港铁）：港岛线和荃湾线的实时时刻表查询。
- \[x\] 旅行（Amap）：POI搜索和步行路线。
- \[x\] 服务模拟：微信/支付宝/滴滴/美团/淘宝的基本结构。
- \[ \] 食品配送（演示）：模拟订购过程（搜索商店->菜单->购物车）。
- \[ \] 基本配置：环境变量和项目结构。
第二阶段：亚洲扩张（新！）
- \[x\] 结构设置：新加坡（Grab）、日本（LINE）、韩国（Naver）的服务目录。
- \[x\] 初始模拟：拼车预订、LINE支付请求、Naver地图搜索。
- \[ \] 真正的API集成：用真正的API（Grab Developer，LINE Pay API）替换mock。
- \[ \] 更多服务：Kakao Pay（KR），雅虎！交通（日本）、EZ-Link（新加坡）。
第三阶段：生态系统
- \[ \] 插件系统：允许社区贡献个人服务工具。
- \[ \] 用户身份验证：个人服务的安全用户令牌管理。
______________________________________________________________________
🚀 入门指南
先决条件
- Node.js>=18
- npm或纱线
安装
- 克隆存储库：
git clone https://github.com/arthurpanhku/DragonMCP.git
cd DragonMCP- 安装依赖项：
npm install- 配置环境变量：
cp .env.example .env
# Edit .env (AMAP_API_KEY required for map services)最小推荐变量：
AMAP_API_KEY：Amap搜索和路由工具所需。JWT_SECRET和ENCRYPTION_KEY：需要时NODE_ENV=production.
运行服务器
启动支持SSE的开发服务器：
npm run dev服务器将在以下时间启动 http://localhost:3000. SSE端点： http://localhost:3000/mcp/sse
使用Docker运行
- 构建并启动容器：
docker-compose up -d --build- 查看日志：
docker-compose logs -f- 停止服务器：
docker-compose down连接到克劳德桌面
- 构建项目：
npm run build- 将以下内容添加到您的
claude_desktop_config.json:
{
"mcpServers": {
"DragonMCP": {
"command": "node",
"args": ["/path/to/DragonMCP/dist/server.js"],
"env": {
"NODE_ENV": "production",
"AMAP_API_KEY": "your_amap_api_key_here"
}
}
}
}*（注：更换 /path/to/DragonMCP 与您的实际绝对路径）*
______________________________________________________________________
❓ 常见问题解答和故障排除
Q： 为什么我在港铁查询时得到“找不到车站”？
A： 目前，仅 港岛线 和 荃湾线 支持。请检查车站名称拼写是否正确（例如“金钟”、“中环”、“旺角”）。
Q： 如何获取Amap（高德）API密钥？
A： 您需要在 Amap开放平台，创建一个“Web服务”应用程序，并将密钥复制到您的 .env 归档 AMAP_API_KEY.
Q： 我可以用它进行真实支付吗？
A. 号码 目前的支付工具都是模拟的。不要将它们用于真实交易。
______________________________________________________________________
🧪 测试
运行单元和集成测试：
npm test如果您的本地Node/Jest设置需要ESM标志，您可以运行：
NODE_OPTIONS="$NODE_OPTIONS --experimental-vm-modules" npm test______________________________________________________________________
🤝 贡献
我们欢迎所有的贡献！无论你是开发人员、设计师还是产品思考者。
我们需要帮助：
- 剧作家脚本：模拟送餐应用（美团/Ele.me）的网络流量。
- 更多地铁线路：添加东铁线、屯门线等车站数据。
- 真正的API集成：用微信/支付宝/滴滴的真实API取代模拟。
看 贡献.md 了解详情。
______________________________________________________________________
🙏 致谢
- Anthropic：用于创建模型上下文协议（MCP）。
- 地铁公司：用于提供开放数据API。
- 阿马普（高德）：用于地图和POI服务。
______________________________________________________________________
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。