MCP 服务器

DB Timetable MCP Server

通过模型上下文协议工具和资源，提供对德国铁路列车时刻表、车站信息和时刻表变更的访问。

README

DB Timetable MCP 服务器

一个用于 Deutsche Bahn Timetable API 的模型上下文协议 (MCP) 服务器。该服务器提供 MCP 工具和资源，用于访问 Fahrplandaten（时刻表数据）、Stationsinformationen（车站信息）和 Zugänderungen（列车变更）。

署名义务：

本项目提供 Deutsche Bahn 的 Fahrplandaten（时刻表数据），这些数据在 Creative Commons Attribution 4.0 International License (CC BY 4.0) 下公开可见。

有关 API 和许可条款的更多信息，请访问 developers.deutschebahn.com。 API 请求受许可条款的约束。

功能

当前时刻表：检索车站的当前时刻表数据
时刻表变更：跟踪最新变更
计划时刻表：访问特定时间的计划时刻表数据
车站搜索：按名称或代码搜索火车站

前提条件

Node.js 18 或更高版本
DB Timetable API 的 API 凭据（客户端 ID 和客户端密钥）

安装

克隆存储库：
```
git clone <repository-url>
cd db-mcp
```
安装依赖项：
```
npm install
```
编译 TypeScript 代码：
```
npm run build
```

配置

在项目的根目录中创建一个 .env 文件，其中包含以下环境变量：

DB_TIMETABLE_CLIENT_ID=你的-client-id
DB_TIMETABLE_CLIENT_SECRET=你的-client-secret
TRANSPORT_TYPE=stdio
PORT=8080
SSE_ENDPOINT=/sse
LOG_LEVEL=info

配置选项

DB_TIMETABLE_CLIENT_ID：DB API 的客户端 ID（必需）
DB_TIMETABLE_CLIENT_SECRET：DB API 的客户端密钥（必需）
TRANSPORT_TYPE：MCP 服务器的传输类型（stdio 或 sse，默认值：stdio）
PORT：SSE 服务器的端口（默认值：8080）
SSE_ENDPOINT：SSE 连接的端点（默认值：/sse）
LOG_LEVEL：日志记录级别（debug、info、warn、error，默认值：info）

使用

启动服务器

在 stdio 模式下（用于 CLI 测试和调试）：

npm start

在 SSE 模式下（用于 Web 客户端）：

TRANSPORT_TYPE=sse npm start

使用 Inspect 模式测试

可以使用 FastMCP Inspector 测试服务器：

npx fastmcp inspect path/to/index.js

MCP 工具

服务器提供以下工具：

getCurrentTimetable：检索车站的当前时刻表数据
- 参数：evaNo - 车站的 EVA 编号（例如，法兰克福中央火车站为 8000105）
getRecentChanges：检索车站的最新变更
- 参数：evaNo - 车站的 EVA 编号（例如，法兰克福中央火车站为 8000105）
getPlannedTimetable：检索车站的计划时刻表数据
- 参数：
  - evaNo - 车站的 EVA 编号（例如，法兰克福中央火车站为 8000105）
  - date - YYMMDD 格式的日期（例如，230401 代表 2023 年 4 月 1 日）
  - hour - HH 格式的小时（例如，14 代表 14 点）
findStations：根据搜索模式搜索车站
- 参数：pattern - 搜索模式（例如，“Frankfurt”或“BLS”）

MCP 资源

服务器提供以下资源：

当前时刻表数据：db-api:timetable/current/{evaNo}
当前时刻表变更：db-api:timetable/changes/{evaNo}
计划时刻表数据：db-api:timetable/planned/{evaNo}/{date}/{hour}
车站搜索：db-api:station/{pattern}

开发

项目结构

db-mcp/
├── src/
│   ├── api/             # API 客户端和类型
│   ├── tools/           # MCP 工具
│   ├── resources/       # MCP 资源
│   ├── utils/           # 辅助函数
│   ├── config.ts        # 配置
│   └── index.ts         # 主要入口点
├── dist/                # 编译后的文件
├── .env                 # 环境变量
├── package.json
├── tsconfig.json
└── README.md