NS Travel Information MCP Server

NS 旅行信息 MCP 服务

让你的 AI 助手成为荷兰铁路专家！此 MCP 服务将 Claude 接入 NS（Nederlandse Spoorwegen）的实时旅行信息，是你乘火车畅游荷兰的理想伴侣。

安装

你可以通过以下三种方式安装此服务：

1. 使用 Claude Desktop 和 NPM 包

更新你的 Claude 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "ns-server": {
      "command": "npx",
      "args": [
        "-y",
        "ns-mcp-server"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

你可以从 NS API Portal 获取 API 密钥。

2. 使用 Smithery

通过 Smithery 自动安装 NS Travel Information Server：

npx -y @smithery/cli install ns-server --client claude

3. 从源代码安装

1. 克隆此仓库
2. 安装依赖：

   npm install
   

3. 复制示例环境文件：

   cp .env.example .env
   

4. 将你的 NS API 密钥添加到 .env 文件中：

   NS_API_KEY=your_api_key_here
   

然后更新你的 Claude 配置文件：

{
  "mcpServers": {
    "ns-server": {
      "command": "node",
      "args": [
        "/path/to/ns-server/build/index.js"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

请务必：

1. 将 /path/to/ns-server 替换为你的实际安装路径
2. 在 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 点在 The Hague 的会议？”
• “在 Amsterdam 玩了一晚后，返回 Groningen 的末班车是什么时候？”
• “周末有没有可能影响我周一早上课程的铁路施工？”
• “Utrecht Centraal 有可供我去参加下午会议的 OV-fiets 自行车吗？”
• “Eindhoven Strijp-S 车站是否无障碍？有哪些站台？”
• “未来一小时内有哪些火车抵达 Utrecht Centraal？”
• “从 Venlo 开往 Schiphol Airport 的火车是否准点到达？”
• “从 Amsterdam 到 Rotterdam 的一等车票多少钱？”
• “2 名成人和 1 名儿童前往 Den Haag 需要多少钱？”

🔑 环境变量

变量	描述
NS_API_KEY	你的 NS API 密钥（必填）

🌟 功能

此 MCP 服务通过以下端点全面提供 NS 列车信息：

实时列车信息

• 出发信息：获取实时出发信息，包括站台编号、延误和出行提示
• 到达信息：查看即将到达的列车，包括始发站、站台变更和状态更新
• 行程规划：查找最优出行路线，包括换乘和实时更新
• 服务更新：查看运营中断、维护工作和铁路施工信息

票价信息

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

车站信息

• 车站详情：获取全面的车站信息，包括：
  • 设施和无障碍功能
  • 站台布局和轨道信息
  • OV-fiets（自行车租赁）的可用情况
  • 位置和到达路线详情

其他功能

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

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。