한국어 | Deutsch

DB 시간표 MCP 서버

공식 Deutsche Bahn Timetables API에 대한 모델 콘텍스 프로토콜 서버. 컴팩트한 DB XML을 semantic JSON으로 변환하고, 1개의 역 보드로 실시간 변경으로 계획된 일정을 병합합니다.

어떤 보증

• Correct 플랫폼 및 시간. effective]는 표시 값이 붙습니다. planned와 changed]는 편차를 설명합니다.
• ** 모델에 내장 된 출력. ** 도구 반환 structuredContent, descriptive JSON schemas, MCP 자원으로 사용할 수있는 데이터 모델.
• MCP 준수. 로컬 클라이언트를 위한 공식 TypeScript SDK, 원격 조작을 위한 stateless Streamable HTTP.
• ** 안전 기본.** stdout]에 로그 없음, 변경하지 않는 루프백 바인딩, 호스트 허용 목록, 타임 아웃, 비 루트 컨테이너, 재현 가능한 lockfile.
• Verifiable 행동. 단위, 계약 및 운송 테스트, 적용 임계값, 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