用途
ns-mcp-server 是一个 Model Context Protocol(MCP)服务器,旨在将 Claude AI 转变为荷兰铁路出行专家。它连接 Claude 与荷兰铁路(NS)的实时旅行信息,让 AI 助手能够查询列车时刻、延误、中断、票价和车站设施等,帮助用户规划在荷兰的火车出行。
主要能力
该服务器通过官方 NS API 提供以下端点能力:
实时列车信息
- 出发信息:获取实时出发信息,包括站台号、延误和旅行备注。
- 到达信息:获取即将到达的列车信息,包括始发站、站台变更和状态更新。
- 行程规划:查找最优出行路线,包含换乘和实时更新。
- 服务更新:检查中断、维护工作和工程活动。
票价信息
- 票价:获取单程和往返行程的准确价格。
- 旅行等级:比较头等舱和二等舱价格。
- 团体票价:计算成人和儿童票价。
- 折扣选项:查看联合出行折扣和特别优惠。
- 有效期详情:查看车票有效期和旅行条件。
车站信息
- 车站详情:获取全面的车站信息,包括设施和无障碍功能、站台布局和轨道信息、OV-fiets(自行车租赁)可用性、位置和到达详情。
附加功能
- 多语言支持:信息提供荷兰语和英语。
- 灵活查询:可按车站名称、代码或 UIC 标识符搜索。
- 时区处理:正确处理国际车站的时区。
- 状态更新:实时跟踪变更、延误和取消。
使用方式
可以通过三种方式安装该服务器:
- 使用 Claude Desktop 配合 NPM 包:更新 Claude 配置文件(
~/Library/Application Support/Claude/claude_desktop_config.json),API 密钥可从 NS API Portal 获取。 - 使用 Smithery:通过 Smithery 自动安装 NS Travel Information Server。
- 手动安装:克隆仓库,安装依赖(
npm install),复制示例环境文件(cp .env.example .env),在.env文件中添加 NS API 密钥(NS_API_KEY=your_api_key_here),然后更新 Claude 配置文件,将/path/to/ns-server替换为实际安装路径,并在 env 部分添加 NS API 密钥(可从 https://apiportal.ns.nl/product#product=NsApp 获取)。更新配置后,重启 Claude Desktop 使更改生效。
适用场景
该服务器适用于多种实际场景,例如:
- 查询常用列车是否准点(如“我平时 8:15 从 Almere 到 Amsterdam 的火车准点吗?”)。
- 检查特定路线是否有延误(如“今天 Rotterdam-Den Haag 路线有延误吗?”)。
- 在直达线路维护时寻找替代路线(如“如果直达线路维护,去 Utrecht 的最佳替代路线是什么?”)。
- 规划到达时间(如“我应该坐哪趟火车才能在 9 点前到达 Amsterdam Zuid 的办公室?”)。
- 考虑换乘次数(如“带婴儿车去 Amsterdam 哪条路线换乘最少?”)。
- 查询首末班车(如“参加 10 点海牙会议最早能坐哪趟火车?”或“在 Amsterdam 夜出后回 Groningen 的末班车是几点?”)。
- 检查周末工程是否影响周一课程。
- 查询车站设施(如“Utrecht Centraal 有 OV-fiets 自行车吗?”或“Eindhoven Strijp-S 站是否轮椅无障碍,有哪些站台?”)。
- 查询到达信息(如“接下来一小时内有哪些列车到达 Utrecht Centraal?”或“从 Venlo 到 Schiphol Airport 的火车准点到达了吗?”)。
- 查询票价(如“从 Amsterdam 到 Rotterdam 的头等舱票价是多少?”或“2 名成人和 1 名儿童去 Den Haag 的价格是多少?”)。
限制
使用该服务器需要 NS API 密钥,需从 NS API Portal 获取。项目采用 MIT 许可证。关于具体的 API 调用限制、速率限制或数据更新频率等细节,官方资料暂未提供。