Tmap MCP

🚀 使用 Tmap REST API 構建 MCP 服務器

本項目藉助 Tmap REST API 搭建了 MCP（模型上下文協議）服務器，其核心價值在於讓 Cursor 編輯器等 AI 工具能夠便捷地調用 Tmap API 的各項功能。項目使用 pymcp 庫來實現相關功能。

✨ 主要特性

• 位置搜索（涵蓋 POI 搜索、地址搜索）
• 地理編碼及反地理編碼
• 行人路徑指引
• 汽車路徑指引
• 即時交通擁堵信息查詢
• 時間機器路徑指引
• 公共交通路徑指引
• 公共交通路徑摘要信息
• 支持 Tmap API 的其他功能

📦 安裝指南

基本要求

• Python 3.6 或更高版本
• Tmap API 應用密鑰
• Cursor 編輯器（使用 AI 功能時需要）

包件安裝

使用以下命令安裝所需的 Python 包：

pip install pymcp requests

Tmap API 密鑰配置

在 Windows 系統中，可通過以下命令設置環境變量：

set TMAP_APP_KEY=your_tmap_api_key

若希望該配置永久生效，請將其添加到系統環境變量中。

💻 使用示例

1. 啟動 MCP 服務器

運行以下腳本啟動 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：查詢地鐵車廂的下車比例