使用说明
tmap_mcp
构建基于Tmap REST API的模型上下文协议（MCP）服务器
概述
该项目将T映射REST API作为模型上下文协议（MCP）服务器提供，允许直接从AI工具（如Cursor编辑器）调用T映射API功能。使用pymcp库实现。
主要功能
- 位置搜索（POI搜索，地址搜索）
- 地理编码和反向地理编码
- 行人路线指南
- 汽车路线指南
- 实时混乱度查询
- 时间机器路径指南
- 公共交通路线介绍
- 公共交通路线摘要
- 其他T映射API功能
安装和设置
基本要求
- Python 3.6或更高版本
- T映射API应用程序密钥
- Cursor编辑器（使用AI功能）
安装软件包
pip install pymcp requests
设置T映射API密钥
在Windows中，可以使用以下命令设置环境变量：
set TMAP_APP_KEY=your_tmap_api_key
要永久设置，请将其添加到系统环境变量中。
使用方法
1.运行MCP服务器
run_mcp_server.bat
如果运行时未将T映射API键设置为环境变量，则会显示输入提示。
2.与Cursor编辑器连接（可选）
要在Cursor编辑器中通过MCP服务器使用T映射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：查询各地铁车厢的下车率
文件结构
mcp_server.py-实施MCP服务器run_mcp_server.bat-在Windows上运行服务器的批处理文件setup_cursor.py-Cursor编辑器设置脚本run_setup_cursor.bat-配置脚本执行批处理文件tmap_api/-T映射API包tmap_api.py-T映射API类
