SuperAPI AI 工具集

ns-mcp-server

ns-mcp-server 是一个基于 Model Context Protocol(MCP)的服务器,用于让 Claude AI 接入荷兰铁路(NS,Nederlandse Spoorwegen)的实时旅行信息。它通过官方 NS API 获取实时列车信息、中断与维护情况,使 AI 助手能够回答荷兰火车出行相关问题。该服务器支持通过 Claude Desktop 配合 NPM 包、Smithery 或手动克隆仓库等方式安装,需要配置 NS API 密钥。主要能力包括实时出发与到达信息、行程规划、服务更新、票价查询以及车站详情等,信息支持荷兰语和英语。

访问官网

工具介绍

用途

ns-mcp-server 是一个 Model Context Protocol(MCP)服务器,旨在将 Claude AI 转变为荷兰铁路出行专家。它连接 Claude 与荷兰铁路(NS)的实时旅行信息,让 AI 助手能够查询列车时刻、延误、中断、票价和车站设施等,帮助用户规划在荷兰的火车出行。

主要能力

该服务器通过官方 NS API 提供以下端点能力:

实时列车信息

  • 出发信息:获取实时出发信息,包括站台号、延误和旅行备注。
  • 到达信息:获取即将到达的列车信息,包括始发站、站台变更和状态更新。
  • 行程规划:查找最优出行路线,包含换乘和实时更新。
  • 服务更新:检查中断、维护工作和工程活动。

票价信息

  • 票价:获取单程和往返行程的准确价格。
  • 旅行等级:比较头等舱和二等舱价格。
  • 团体票价:计算成人和儿童票价。
  • 折扣选项:查看联合出行折扣和特别优惠。
  • 有效期详情:查看车票有效期和旅行条件。

车站信息

  • 车站详情:获取全面的车站信息,包括设施和无障碍功能、站台布局和轨道信息、OV-fiets(自行车租赁)可用性、位置和到达详情。

附加功能

  • 多语言支持:信息提供荷兰语和英语。
  • 灵活查询:可按车站名称、代码或 UIC 标识符搜索。
  • 时区处理:正确处理国际车站的时区。
  • 状态更新:实时跟踪变更、延误和取消。

使用方式

可以通过三种方式安装该服务器:

  1. 使用 Claude Desktop 配合 NPM 包:更新 Claude 配置文件(~/Library/Application Support/Claude/claude_desktop_config.json),API 密钥可从 NS API Portal 获取。
  2. 使用 Smithery:通过 Smithery 自动安装 NS Travel Information Server。
  3. 手动安装:克隆仓库,安装依赖(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 调用限制、速率限制或数据更新频率等细节,官方资料暂未提供。