日本語 | Deutsch

DBタイムテーブルMCPサーバー

公式のDeutsche Bahn Timetables API 用のモデルコンテキストプロトコルサーバー。 コンパクトなDBXMLを分離JSONに変換し、計画されたスケジュールを1つのステーションボードに統合します。

それが保証するもの

• プラットフォームと時間を調整します。 effective]]は表示する値を保持します。 [planned]と[changed]]]は、偏差を説明します。
• モデルの出力。 ツールは[structuredContent、記述JSONスキーマ、MCPリソースとして利用可能なデータモデルを返します。
• MCPの適合。 公式のTypeScript SDK、ローカルクライアント用のstdio、リモート操作用のステートレスなストリーミング可能なHTTP。
• 安全なデフォルト。 [stdoutのログなし、それを変更しない限り、ループバックバインディング、ホスト allowlist、タイムアウト、非rootコンテナ、再現可能なロックファイル。
• 検証可能な動作。 ユニット、契約、輸送試験、カバレッジ閾値、CI、依存性および秘密チェック。

クイックスタート

要件: Node.js 22 または 24 LTS および DB API Marketplace のサブスクリプションタイムテーブル製品。

[.envに記入します。

ビルドと開始:

stdio モードでは、プロセスは MCP クライアントを待ちます。 ステータスメッセージは[stderrのみになります.

English | Deutsch

DB Timetable MCP Server

A Model Context Protocol server for the official Deutsche Bahn Timetables API. It converts the compact DB XML into semantic JSON and merges the planned schedule with live changes into one station board.

What it guarantees

• Correct platforms and times. effective holds the value to display. planned and changed explain the deviation.
• Output built for models. Tools return structuredContent, descriptive JSON schemas, and a data model available as an MCP resource.
• MCP conformance. Official TypeScript SDK, stdio for local clients, stateless Streamable HTTP for remote operation.
• Safe defaults. No logs on stdout, loopback binding unless you change it, host allowlist, timeouts, non-root container, reproducible lockfile.
• Verifiable behaviour. Unit, contract, and transport tests, coverage thresholds, CI, dependency and secret checks.

Quick start

Requirements: Node.js 22 or 24 LTS, and a subscribed Timetables product in the DB API Marketplace.

git clone https://github.com/jorekai/db-timetable-mcp.git
cd db-timetable-mcp
npm ci
cp .env.example .env

Fill in .env:

DB_TIMETABLE_CLIENT_ID=deine-client-id
DB_TIMETABLE_CLIENT_SECRET=dein-api-key

Then build and start:

npm run build
npm start

In stdio mode the process waits for an MCP client. Status messages go to stderr only. stdout stays reserved for JSON-RPC.

Claude Desktop

Run npm ci && npm run build first, then point the configuration at an absolute path in claude_desktop_config.json.

macOS/Linux:

{
  "mcpServers": {
    "db-timetable": {
      "command": "node",
      "args": ["/absolute/path/db-timetable-mcp/dist/index.js"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "db-timetable": {
      "command": "node",
      "args": ["C:\\absolute\\path\\db-timetable-mcp\\dist\\index.js"]
    }
  }
}

The .env file is looked up in the current working directory and next to the project directory, which covers the case where Claude Desktop starts the compiled server from somewhere else. You can also set the two credentials in the env object of the MCP entry instead.

After a configuration change, quit Claude Desktop completely and start it again. More in Troubleshooting.

Tools