使用 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 功能，请按照以下步骤操作：

1. 运行配置脚本：

run_setup_cursor.bat

2. 重新启动 Cursor 编辑器。

3. 在 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：查询地铁车厢的下车比例