AI导哈

列车时刻表API服务

基于Bun的波兰列车时刻表API服务器，提供车站、班次、连接、列车路线、座位数据和实时时刻表等14种工具。

  • by dalist1
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 dalist1/koleobun-mcp

使用说明

koleobun mcp

基于Bun的MCP服务器 科洛 波兰列车时刻表API。

它公开了与Python MCP相同的14个工具，包括车站、线路板、连接、列车路线、座位数据和实时时刻表。

受原始Python实现的启发： MBratkowski/koleo mcp.

需求

  • 支持的Bun： 1.4.x （测试于 1.4.0)

快速开始

使用bunx直接从npm运行：

bunx koleobun-mcp

如果命令启动时没有崩溃，则MCP服务器已准备就绪。

本地开发

bun install
bun run start

质量检查

bun run format
bun run lint
bun run typecheck

使用MCP检查员进行测试

bunx @modelcontextprotocol/inspector bunx koleobun-mcp

然后调用这些工具：

  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

Claude桌面配置

将此添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "koleo": {
      "command": "bunx",
      "args": ["koleobun-mcp"]
    }
  }
}

身份验证（可选，实时需要）

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

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

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

可用工具

工具 说明
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 列出承运商

相关 MCP