Belgian Train Schedule

iRail MCP サーバー

免責事項： このプロジェクトはバイブコーディングで作成されたもので、iRail vzwとは提携しておらず、サポートも受けていません。列車のデータは不正確または古い可能性があります。旅行の計画を立てる前に、必ず公式情報（belgiantrain.beまたはNMBS/SNCBアプリ）で確認してください。

iRail APIを通じてベルギーの鉄道旅行情報を提供する、Model Context Protocol（MCP）サーバーです。

機能

• 駅の検索 - ベルギーの鉄道駅を名前で検索します
• 発車・到着情報のライブ表示 - 発車・到着案内をリアルタイムで表示します
• 乗り継ぎ検索 - 乗り換えを含む駅間のルートを検索します
• 列車情報 - 特定の列車の停車駅、遅延、ホームの詳細情報を表示します
• 運行障害情報 - 現在の運行障害や計画された保守作業を表示します

インストール

Python 3.11+とuvが必要です。

git clone https://github.com/HansF/irail-mcp.git
cd irail-mcp
uv venv && source .venv/bin/activate
uv pip install -e .

Claude Code での使用方法

プロジェクトの.mcp.jsonに追加します：

{
  "mcpServers": {
    "irail": {
      "command": "uvx",
      "args": ["irail-mcp"]
    }
  }
}

次のような質問をClaudeにできます：

• 「次の1時間にブリュッセル中央駅を出発する列車は？」
• 「明日の午後2時30分にアントワープからブルージュへ行くルートを探して」
• 「ベルギーの鉄道網で運行障害は発生していますか？」
• 「列車IC2240の詳細を表示して」

ツール

search_stations

駅名で駅を検索します。

• query（必須）- 駅名または名前の一部
• lang（任意）- 言語：en、nl、fr、de、it

get_liveboard

駅の発車または到着情報をリアルタイムで表示します。

• station（必須）- 駅名
• date（任意）- YYYY-MM-DD、「today」、「tomorrow」、「+2 days」
• time（任意）- HH:MM（24時間表記）
• arrival（任意）- 発車情報の代わりに到着情報を表示します
• lang（任意）

find_connections

2つの駅間のルートを検索します。

• from_station（必須）- 出発駅
• to_station（必須）- 目的地の駅
• date、time、lang（任意）
• arrival_time（任意）- trueの場合、時刻は希望する到着時刻です

get_train_info

特定の列車の詳細情報を表示します。

• train_id（必須）- 例：「IC1234」または「BE.NMBS.IC1234」
• date、lang（任意）

get_disturbances

現在の運行障害と計画された工事を表示します。

• lang（任意）

テストの実行

uv pip install -e ".[dev]"
python -m pytest tests/ -v

API 準拠

• iRailのガイドラインに従い、リクエスト数を毎秒3回に制限します
• 適切なUser-Agentヘッダーを設定します
• 応答が遅い場合に備え、タイムアウトを30秒に設定します

ライセンス

MIT

参考資料

• iRail API - ドキュメント
• Model Context Protocol
• NMBS/SNCB