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}

📦 安裝指南

安裝要求

• Node.js 版本：18 或更高版本
• 德國鐵路 API 憑證：需要客戶端 ID 和秘密，用於身份驗證

安裝步驟

1. 克隆項目倉庫到本地：

   git clone <repository-url>
   

2. 進入項目目錄：

   cd db-mcp
   

3. 安裝依賴項：

   npm install
   

4. 構建 TypeScript 代碼：

   npm run build
   

💻 使用示例

基礎用法

啟動服務器：

npm start

默認情況下，服務器將在 process.env.PORT 端口（默認為 3000）上運行。

高級用法

在開發模式下，服務器會自動重新加載以響應代碼更改：

npm run dev

📚 詳細文檔

項目結構

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