pypi oebb-mcp-serverstdioMITupdated 8d ago
MCP server for OeBB (Austrian Federal Railways) train data. Query Austrian train stations, departures, connections, and service alerts directly from LLMs via the Model Context Protocol.
Was kannst du mit OeBB (Austrian Railways) machen?
oebb-mcp-server
MCP server for OeBB (Austrian Federal Railways) train data. Query Austrian train stations, departures, connections, and service alerts directly from LLMs via the Model Context Protocol.
Installation
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"oebb": {
"command": "uvx",
"args": ["oebb-mcp-server"]
}
}
}
Claude Code
claude mcp add oebb -- uvx oebb-mcp-server
From source (development)
{
"mcpServers": {
"oebb": {
"command": "uvx",
"args": ["--from", "/path/to/oebb-mcp-server", "oebb-mcp-server"]
}
}
}
Tools
search_station
Search OeBB stations by name. Returns matching stations with IDs, coordinates, and types.
| Parameter | Type | Default | Description |
|---|---|---|---|
query |
string | required | Station name (e.g. "Wien Hbf") |
max_results |
int | 10 | Maximum results |
station_board
Fetch live departures or arrivals at a station. Provide either station_id or station_name.
| Parameter | Type | Default | Description |
|---|---|---|---|
station_id |
string | — | OeBB station ID (e.g. "1190100") |
station_name |
string | — | Station name (auto-resolved) |
board_type |
string | "DEP" | "DEP" for departures, "ARR" for arrivals |
max_journeys |
int | 10 | Maximum journeys |
trip_search
Search train connections between two stations. Supports time planning and direct-only filtering.
| Parameter | Type | Default | Description |
|---|---|---|---|
from_station_id |
string | — | Departure station ID |
from_station_name |
string | — | Departure station name |
to_station_id |
string | — | Arrival station ID |
to_station_name |
string | — | Arrival station name |
max_connections |
int | 5 | Maximum connections |
time |
string | now | ISO 8601 time (e.g. "2026-04-15T08:00:00") |
time_mode |
string | "departure" | "departure" or "arrival" |
direct_only |
bool | false | Only direct connections |
service_alerts
Fetch current OeBB service alerts and disruptions.
| Parameter | Type | Default | Description |
|---|---|---|---|
max_alerts |
int | 20 | Maximum alerts |
product_filter |
int | 65535 | Product bitmask (1=ICE/RJX, 2=IC/EC, 4=NJ, 8=D/EN, 16=REX/R, 32=S-Bahn, 64=Bus, 128=Ferry, 256=U-Bahn, 512=Tram, 4096=private operators like Westbahn/RegioJet, 65535=all) |
Development
# Install dependencies
uv sync
# Lint & format
ruff check .
ruff format .
# Run unit tests
pytest tests/ -v -m "not integration"
# Run integration tests (hits real OeBB API)
pytest tests/ -v -m integration
License
MIT
Installation
OeBB (Austrian Railways) zu deinem Client hinzufügen. Wähl den, den du nutzt.
claude mcp add oebb-mcp-server -- uvx oebb-mcp-servercodex mcp add oebb-mcp-server -- uvx oebb-mcp-serveramp mcp add oebb-mcp-server -- uvx oebb-mcp-server{
"mcpServers": {
"oebb-mcp-server": {
"command": "uvx",
"args": [
"oebb-mcp-server"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"oebb-mcp-server": {
"command": "uvx",
"args": [
"oebb-mcp-server"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"oebb-mcp-server","command":"uvx","args":["oebb-mcp-server"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"oebb-mcp-server": {
"command": "uvx",
"args": [
"oebb-mcp-server"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"oebb-mcp-server": {
"command": "uvx",
"args": [
"oebb-mcp-server"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"oebb-mcp-server": {
"command": "uvx",
"args": [
"oebb-mcp-server"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"oebb-mcp-server": {
"type": "local",
"command": "uvx",
"args": [
"oebb-mcp-server"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"oebb-mcp-server": {
"command": {
"path": "uvx",
"args": [
"oebb-mcp-server"
]
}
}
}
}Add to your Zed `settings.json`.
uvx oebb-mcp-serverRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Unvollständig
- Dokumentation18/25
- Pflege25/25
- Vertrauen13/20
- Funktionsumfang0/15
- Installation12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 1 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Versionsverlauf
| Versionen | Veröffentlicht |
|---|---|
| 0.2.5Aktuell | 31. Aug. 2026 |
| 0.2.4 | 23. Aug. 2026 |
| 0.2.3 | 22. Aug. 2026 |
| 0.2.2 | 10. Aug. 2026 |
| 0.2.1 | 29. Juli 2026 |
| 0.2.0 | 29. Juli 2026 |
| 0.1.3 | 29. Juli 2026 |
| 0.1.2 | 5. Juli 2026 |
| 0.1.1 | 5. Juli 2026 |