返回 MCP 目录
public公开dns本地运行

ns-mcp-server

NS旅行信息MCP服务器将AI助手转变为荷兰铁路专家,提供实时列车信息查询服务

article

README

🚀 NS 旅行信息 MCP 服务器

将您的 AI 助手变成荷兰铁路专家!此 MCP 服务器连接了 Claude 和实时 NS(Nederlandse Spoorwegen)旅行信息,让它成为您在荷兰乘火车出行的理想伴侣。

🚀 快速开始

此 MCP 服务器能将您的 AI 助手打造成荷兰铁路专家,通过连接 Claude 和实时 NS 旅行信息,为您的荷兰火车出行提供便利。

📦 安装指南

您可以使用三种方式安装此服务器:

1. 使用 Claude 桌面版本的 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 门户 获取一个 API 密钥。

2. 使用 Smithery

通过 Smithery 自动安装 NS 旅行信息服务器:

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": [
        "./ns-mcp-server"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

✨ 主要特性

  • 实时列车信息:获取最新的火车时刻表、延误和取消信息。
  • 车站详情:查看车站设施、无障碍通道信息和 OV - fiets(自行车租赁)可用性。
  • 票价信息:比较不同旅行阶级(一等座和二等座)的票价,并享受团体折扣和优惠。

📚 详细文档

环境变量

| 属性 | 详情 | |------|------| | 变量名 | 描述 | | NS_API_KEY | 必需。NS API 的访问密钥 |

💻 使用示例

基础用法

# 示例:查询实时列车信息
curl -X POST http://localhost:7001/ns-train-info \
     -H "Content-Type: application/json" \
     -d '{"station":"Amsterdam"}'

📄 许可证

此项目在 MIT 许可证下,详情请参见 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端