Db Timetable MCP

🚀 ドイツ鉄道 (DB) 時刻表 MCP サーバー

このプロジェクトは、Node.js をベースにした MCP サーバーで、ドイツ鉄道（Deutsche Bahn, DB）の時刻表データを処理するためのものです。開発者に対して、DB のリアルタイムおよび予定された列車情報にアクセスし、クエリを実行するためのインターフェースを提供します。

🚀 クイックスタート

このサーバーを使用することで、ドイツ鉄道の時刻表データにアクセスできます。以下の手順に従ってセットアップしてください。

📦 インストール

インストール要件

• Node.js バージョン：18 以上
• ドイツ鉄道 API の認証情報：クライアント ID とシークレットが必要で、認証に使用されます。

インストール手順

1. プロジェクトリポジトリをローカルにクローンします。

   git clone <repository-url>
   

2. プロジェクトディレクトリに移動します。

   cd db-mcp
   

3. 依存関係をインストールします。

   npm install
   

4. TypeScript コードをビルドします。

   npm run build
   

🔧 設定

.env ファイルを作成し、以下の環境変数を含めます。

CLIENT_ID=your_client_id_here
CLIENT_SECRET=your_client_secret_here
PORT=3000

これらの情報は、認証と DB の時刻表 API への接続に使用されます。

💻 サーバーの起動

以下の npm スクリプトでサーバーを起動できます。

npm start

デフォルトでは、サーバーは process.env.PORT ポート（デフォルトは 3000）で実行されます。

開発モード

開発モードでは、コードの変更に応じてサーバーが自動的に再読み込みされます。

npm run dev

✨ 主な機能

MCP ツール

1. 現在の時刻表を取得する：
   • エンドポイント：db-api:timetable/current/{evaNo}
   • パラメータ：{evaNo}（駅番号）
2. 最近の変更を取得する：
   • エンドポイント：db-api:timetable/changes/{evaNo}
   • パラメータ：{evaNo}（駅番号）
3. 予定された時刻表を取得する：
   • エンドポイント：db-api:timetable/planned/{evaNo}/{date}/{hour}
   • パラメータ：{evaNo}（駅番号）、{date}（日付）、{hour}（時間）
4. 駅検索：
   • エンドポイント：db-api:station/{pattern}
   • パラメータ：{pattern}（検索キーワード）

MCP リソース

1. 現在の時刻表データ：db-api:timetable/current/{evaNo}
2. 予定された時刻表データ：db-api:timetable/planned/{evaNo}/{date}/{hour}
3. 駅検索結果：db-api:station/{pattern}

🔍 プロジェクト構造

db-mcp/
├── src/                 # ソースコードディレクトリ
│   ├── api/             # API クライアントと型定義
│   ├── tools/           # MCP ツール
│   ├── resources/       # MCP リソース
│   ├── utils/           # ユーティリティ関数
│   ├── config.ts        # 設定ファイル
│   └── index.ts         # エントリーポイント
├── dist/                # コンパイル後のコード
├── .env                 # 環境変数ファイル
├── package.json         # 依存関係管理とスクリプト
├── tsconfig.json        # TypeScript 設定
└── README.md            # プロジェクトドキュメント

📜 スクリプト

• npm run build：TypeScript コードをビルドします。
• npm start：サーバーを起動します。
• npm run dev：開発モードでサーバーを起動します（自動再読み込み）。
• npm test：テストスイートを実行します。

🔮 拡張性

潜在的な拡張方向

1. データ処理と強化：
   • XML 時刻表データを構造化された JSON 形式に変換し、セマンティックな強化を行う。
   • 遅延と中断の予測のための履歴データ分析。
   • マルチモード交通接続の統合。
2. 強化された MCP ツール：
   • （駅間の）経路計画機能。
   • AI 駆動の遅延と負荷予測。
   • 旅行障害分析。
   • 駅のアクセシビリティチェック。

📄 ライセンス

• MCP サーバー：MIT License
• DB 時刻表 API：Creative Commons Attribution 4.0 International License