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機能を使用する場合）

パッケージのインストール

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：地下鉄車両の降車割合を照会します。