Belgian Train Schedule

iRail MCP Server

**免责声明：**本项目由 vibe coding 生成，与 iRail vzw 无关，也不受其支持。列车数据可能不准确或已过时。请务必在做出出行决定前，通过官方渠道（belgiantrain.be 或 NMBS/SNCB 应用）核实信息。

一个 Model Context Protocol（MCP）服务，通过 iRail API 提供比利时铁路出行信息。

功能

• 搜索车站 - 按名称查找比利时铁路车站
• 实时出发/到达信息 - 实时出发和到达信息板
• 查找线路 - 查询车站之间的路线及换乘信息
• 列车信息 - 查看指定列车的详细停靠站、延误和站台信息
• 铁路网络中断信息 - 当前运行中断和计划维护信息

安装

需要 Python 3.11+ 和 uv。

git clone https://github.com/HansF/irail-mcp.git
cd irail-mcp
uv venv && source .venv/bin/activate
uv pip install -e .

与 Claude Code 搭配使用

将以下内容添加到项目的 .mcp.json 中：

{
  "mcpServers": {
    "irail": {
      "command": "uvx",
      "args": ["irail-mcp"]
    }
  }
}

然后可以向 Claude 提出以下问题：

• “接下来一小时有哪些列车从布鲁塞尔中央站出发？”
• “帮我查找明天下午 2:30 从安特卫普到布鲁日的路线”
• “比利时铁路网络目前有运行中断吗？”
• “显示 IC2240 次列车的详细信息”

工具

search_stations

按名称搜索车站。

• query（必填）- 车站名称或部分名称
• lang（可选）- 语言：en、nl、fr、de、it

get_liveboard

查看某车站的实时出发或到达信息。

• station（必填）- 车站名称
• date（可选）- YYYY-MM-DD、"today"、"tomorrow"、"+2 days"
• time（可选）- HH:MM（24 小时制）
• arrival（可选）- 显示到达信息，而非出发信息
• lang（可选）

find_connections

查找两个车站之间的路线。

• from_station（必填）- 出发车站
• to_station（必填）- 目的地车站
• date、time、lang（可选）
• arrival_time（可选）- 若为 true，则将时间视为期望的到达时间

get_train_info

查看指定列车的详细信息。

• train_id（必填）- 例如 "IC1234" 或 "BE.NMBS.IC1234"
• date、lang（可选）

get_disturbances

查看当前铁路网络中断和计划施工信息。

• lang（可选）

运行测试

uv pip install -e ".[dev]"
python -m pytest tests/ -v

API 合规性

• 按照 iRail 指南，将请求频率限制为每秒 3 次
• 设置正确的 User-Agent 标头
• 为响应缓慢的请求设置 30 秒超时

许可证

MIT

参考资料

• iRail API - 文档
• Model Context Protocol
• NMBS/SNCB