Thsrc MCP

🚀 MCP Server THSRC - 台灣高鐵資訊查詢服務

これは、Model Context Protocol (MCP) に基づく台湾高鉄の情報検索サーバーです。リアルタイムの高鉄時刻表、駅情報、列車の運行状況、座席情報を提供します。

✨ 主な機能

• 🚄 充実した高鉄情報検索：時刻表、リアルタイムの列車情報、座席状況を検索できます。
• 🌐 多言語対応：中国語の駅名、英語の駅名、駅IDでの検索に対応しています。
• 🔄 リアルタイムデータ：TDX (運輸データ流通サービス) API を統合しています。
• 📱 MCP標準：すべてのMCP対応アプリケーションと互換性があります。

📦 インストール

方法 1：pipxを使用する（推奨）

# pipxをインストールする（まだインストールされていない場合）
python -m pip install --user pipx
python -m pipx ensurepath

# MCPサーバーをインストールする
pipx install git+https://github.com/yourusername/mcp-server-thsrc.git

方法 2：pipを直接使用する

pip install git+https://github.com/yourusername/mcp-server-thsrc.git

方法 3：手動インストール

git clone https://github.com/yourusername/mcp-server-thsrc.git
cd mcp-server-thsrc
pip install -e .

環境設定

1. TDXアカウントを登録する：TDX運輸データ流通サービスプラットフォームにアクセスします。
2. APIキー（Client IDとClient Secret）を取得する。

サービスの起動

python thsrc.py

🚀 クイックスタート

方法 1：npxを使用する（推奨）

インストールせずに直接使用できます。

npx @physictim/mcp-server-thsrc --help

方法 2：pipxを使用する

# pipxをインストールする（まだインストールされていない場合）
python -m pip install --user pipx
python -m pipx ensurepath

# GitHubからインストールする
pipx install git+https://github.com/physictim/thsrc_mcp.git

方法 3：手動インストール

# プロジェクトをクローンする
git clone https://github.com/physictim/thsrc_mcp.git
cd thsrc_mcp

# 仮想環境を作成する
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 依存関係をインストールする
pip install -r requirements.txt

Claude Desktopへの統合

1. TDX APIキーを取得する

TDX運輸データ流通サービスプラットフォームにアクセスして登録し、以下の情報を取得します。

• Client ID
• Client Secret

2. Claude Desktopを設定する

Claude Desktopの設定ファイルを見つけます。 macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

3. 設定ファイルを編集する

claude_desktop_config.jsonに以下の設定を追加します。

npxを使用する場合（推奨）：

{
  "mcpServers": {
    "thsrc": {
      "command": "npx",
      "args": ["-y", "@physictim/mcp-server-thsrc"],
      "env": {
        "TDX_CLIENT_ID": "ここにあなたのClient IDを貼り付ける",
        "TDX_CLIENT_SECRET": "ここにあなたのClient Secretを貼り付ける"
      }
    }
  }
}

pipxを使用してインストールした場合：

{
  "mcpServers": {
    "thsrc-mcp": {
      "command": "mcp-server-thsrc",
      "env": {
        "TDX_CLIENT_ID": "ここにあなたのClient IDを貼り付ける",
        "TDX_CLIENT_SECRET": "ここにあなたのClient Secretを貼り付ける"
      }
    }
  }
}

手動でインストールした場合：

{
  "mcpServers": {
    "thsrc-mcp": {
      "command": "/path/to/your/python3",
      "args": ["/path/to/your/thsrc.py"],
      "env": {
        "TDX_CLIENT_ID": "ここにあなたのClient IDを貼り付ける",
        "TDX_CLIENT_SECRET": "ここにあなたのClient Secretを貼り付ける"
      }
    }
  }
}

4. Claude Desktopを再起動する

Claude Desktopを再起動すると、MCPサーバーが自動的に読み込まれます。

5. 接続を検証する

Claude Desktopで以下のコマンドを入力します。

台湾高鉄の駅リストを調べてください

設定が成功していれば、ClaudeはMCPツールを使用して高鉄の駅情報を検索し、返します。

💻 使用例

基本的な使用法

設定が完了したら、Claude Desktopで自然言語を使用して直接検索できます。

• "明日の台北から左営までの高鉄の便を調べる"
• "現在、台中駅にはどの便がありますか？"
• "823便の明日の詳細情報"
• "台北から高雄までの座席はまだありますか？" Claudeは自動的に対応するMCPツールを呼び出して、リアルタイムのデータを取得します。

高度な使用法

1. 駅リストの検索

get_thsr_stations()

すべての台湾高鉄の駅情報を取得します。

2. 時刻表の検索

get_thsr_timetable("台北", "左營", "2024-01-01")

指定された路線と日付の列車時刻表を検索します。 パラメータの説明：

• origin_station: 出発駅（中国語の駅名、例："台北" または駅ID、例："1000" をサポート）
• destination_station: 到着駅（中国語の駅名、例："左營" または駅ID、例："1070" をサポート）
• travel_date: 乗車日（YYYY-MM-DD形式）

3. リアルタイムの列車情報の検索

get_thsr_live_schedule("台北")

指定された駅のリアルタイムの列車状況を取得します。 パラメータの説明：

• station: 駅名または駅ID

4. 特定の列車の詳細情報の検索

get_thsr_train_info("823", "2024-01-01")

特定の列車番号の詳細情報を検索します。 パラメータの説明：

• train_no: 列車番号
• travel_date: 乗車日（YYYY-MM-DD形式）

5. 残り座席の検索

get_thsr_available_seats("台北", "左營", "2024-01-01")

指定された路線の残り座席の状況を検索します。 パラメータの説明：

• origin_station: 出発駅
• destination_station: 到着駅
• travel_date: 乗車日

更新頻度：

• 当日の検索：10分ごとに更新
• その他の日付：毎日10:00、16:00、22:00に更新

対応駅

リソース

thsr://stations

駅情報を提供するMCPリソースで、MCP対応のアプリケーションで直接アクセスできます。

注意事項

⚠️ 重要な注意事項

1. API制限：TDX APIの使用制限に従ってください。
2. 認証：TDX APIキーが正しく設定されていることを確認してください。
3. 日付形式：日付はYYYY-MM-DD形式で指定する必要があります。
4. 駅名の入力：中国語と英語の駅名に対応しており、大文字と小文字は区別されます。

エラー処理

• 無効な駅名：ValueErrorエラーが発生します。
• API認証失敗：環境変数の設定を確認してください。
• ネットワーク接続問題：ネットワーク接続状況を確認してください。

📄 ライセンス

このプロジェクトはMITライセンス条項の下で提供されています。

関連リンク

• TDX運輸データ流通サービスプラットフォーム
• 台湾高鉄公式ウェブサイト
• Model Context Protocol