Koleo MCP Server

科莱奥·麦克普

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

1. tool_get_departures 与：

- station: Krakow Glowny

1. tool_search_connections 与：

- start: Krakow - end: Warszawa - length: 3

1. tool_get_brands
2. 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 错误。

可用工具

故障排除

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