🚀 使用 Tmap REST API 构建 MCP 服务器
本项目借助 Tmap REST API 打造了 MCP（模型上下文协议）服务器，其核心目标是让 Cursor 编辑器等 AI 工具能够直接调用 Tmap API 的各项功能。项目采用 pymcp 库来完成实现。
✨ 主要特性
- 位置搜索（涵盖 POI 搜索、地址搜索）
- 地理编码及反地理编码
- 行人路径指引
- 汽车路径指引
- 实时交通拥堵信息查询
- 时间机器路径指引
- 公共交通路径指引
- 公共交通路径摘要信息
- Tmap API 的其他功能
📦 安装指南
基本要求
- Python 3.6 或更高版本
- Tmap API 应用密钥
- Cursor 编辑器（使用 AI 功能时）
包件安装
pip install pymcp requests
Tmap API 密钥配置
在 Windows 系统中，可通过以下命令设置环境变量：
set TMAP_APP_KEY=your_tmap_api_key
若希望设置永久生效，请将其添加到系统环境变量。
💻 使用示例
1. 启动 MCP 服务器
run_mcp_server.bat
运行时，若未在环境变量中设置 Tmap API 密钥，系统会提示输入。
2. 与 Cursor 编辑器连接（可选）
若要在 Cursor 编辑器中使用 MCP 服务器的 Tmap API 功能，请按以下步骤操作：
- 运行配置脚本：
run_setup_cursor.bat
- 重新启动 Cursor 编辑器。
- 在 Cursor 编辑器的 AI 面板中选择 'tmap-api' 服务器。
📚 详细文档
位置搜索
search_poi_keyword：通过关键词搜索 POI（兴趣点）search_address_keyword：通过关键词搜索地址search_coord_keyword：通过关键词搜索坐标
地理编码
geocoding：将地址转换为坐标full_text_geocoding：将自由格式的文本地址转换为坐标reverse_geocoding：将坐标转换为地址
路径指引
pedestrian_route_detail：查询行人路径的详细信息pedestrian_route_summary：查询行人路径的摘要信息car_route：汽车路径指引time_machine_route：时间机器汽车路径指引public_transit_route：公共交通路径指引get_subway_congestion：查询地铁列车的拥堵情况
场所信息
get_poi_detail：查询 POI 的详细信息realtime_place_congestion：查询实时场所的拥堵情况
地铁信息
get_subway_congestion：查询地铁车厢的拥堵情况get_subway_station_congestion：查询地铁站台的拥堵情况get_subway_exit_ratio：查询地铁车厢的下车比例