火车时刻表API服务器

Koleo MCP服务器是一个波兰火车时刻表API服务,提供14种工具用于搜索车站、出发/到达时间、连接路线、火车路线、座位数据和实时时刻表。

  • by MBratkowski
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 MBratkowski/koleo-mcp

使用说明

科莱奥·麦克普

MCP服务器 科洛 波兰列车时刻表API。

它提供了14个工具,您可以从Claude Desktop(或任何MCP客户端)调用这些工具来搜索车站、出发/到达、连接、火车路线、座位数据和实时时刻表。

需求

  • Python 3.12+
  • pip

快速启动(复制/粘贴)

git clone https://github.com/MBratkowski/koleo-mcp.git
cd koleo-mcp
python3 -m pip install -e .
python3 server.py

如果 server.py 启动时不会崩溃,服务器已准备就绪。

如何测试服务器(简单模式)

运行MCP检查器:

mcp dev server.py

然后在检查器UI中调用这些工具:

  1. tool_search_stations 与:
    • query: Krakow
  2. tool_get_departures 与:
    • station: Krakow Glowny
  3. tool_search_connections 与:
    • start: Krakow
    • end: Warszawa
    • length: 3
  4. tool_get_brands
  5. tool_get_realtime_timetable 与:
    • train_id:任何整数(例如 12345)

每个工具返回至少包含以下内容的JSON:

  • data
  • summary
  • koleo_url

在出现错误时,您还会收到 error 钥匙。

如何使用Claude Desktop

将此添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "koleo": {
      "command": "python3",
      "args": ["/absolute/path/to/koleo-mcp/server.py"]
    }
  }
}

替换 /absolute/path/to/koleo-mcp/server.py 你真正的道路。

重新启动克劳德桌面。

身份验证(可选,实时工具需要)

创建 ~/.config/koleo-mcp/config.json:

{
  "email": "your@email.com",
  "password": "yourpassword"
}

您可以用以下命令覆盖配置路径 KOLEO_MCP_CONFIG.

如果缺少认证, tool_get_realtime_timetable 返回友好 auth_required 错误。

可用工具

工具 说明
tool_search_stations 按名称搜索电台
tool_get_station_info 车站地址、开放时间、设施
tool_get_departures 从车站出发
tool_get_arrivals 到达车站
tool_get_all_trains 一个车站的所有列车(出发+到达)
tool_search_connections 查找连接A->B
tool_get_train_route 按品牌+编号列出的列车路线
tool_get_train_by_id Koleo列车ID的列车路线
tool_get_train_calendar 列车运行日期
tool_get_realtime_timetable 实时时间表(需要身份验证)
tool_get_seat_stats 路线上的座位占用统计数据
tool_get_seat_availability 按连接ID显示的原始座位图
tool_get_brands 列出列车品牌
tool_get_carriers 列出承运商

故障排除

  • ModuleNotFoundError:run python3 -m pip install -e . 再一次。
  • macOS/Python.org版本上的SSL证书错误:为Python安装安装证书,然后重试。
  • auth_required 对于实时工具:添加 ~/.config/koleo-mcp/config.json 如上所示。