使用说明

项目简介

本项目是一个MCP服务器,旨在为LLM客户端提供访问荷兰铁路(NS)实时出行信息的能力。通过集成NS API,该服务器提供了一系列工具,帮助用户查询列车延误、获取出行建议以及车站的实时出发信息。

主要功能点

  • 查询列车延误 (get_disruptions): 获取当前荷兰铁路网络中的所有列车延误信息,可以根据延误类型和活动状态进行筛选。
  • 获取出行建议 (get_travel_advice): 根据出发站和到达站,查询最优的列车出行方案,并可指定出发或到达时间。
  • 查询车站出发信息 (get_departures): 获取指定车站的实时列车出发列表,包括列车方向、预计发车时间等信息。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/MCP-Mirror/r-huijts_ns-mcp-server.git
  2. 进入项目目录:
    cd r-huijts_ns-mcp-server
  3. 安装依赖:
    npm install
  4. 复制环境变量示例文件:
    cp .env.example .env
  5. 配置 NS API 密钥: 修改 '.env' 文件,将 'NS_API_KEY=your_api_key_here' 替换为你在 NS API Portal 申请的 API 密钥。

服务器配置

要将此MCP服务器添加到MCP客户端(例如 Claude Desktop),您需要配置客户端以连接到此服务器。以下是一个配置示例,您需要将其添加到您的MCP客户端配置文件中。

{
  "servers": {
    "ns-server": {
      "name": "ns-server",
      "command": "node",
      "args": [
        "/path/to/r-huijts_ns-mcp-server/build/index.js" // 将 "/path/to/r-huijts_ns-mcp-server" 替换为你的项目实际安装路径
      ],
      "env": {
        "NS_API_KEY": "YOUR_API_KEY" // 必须替换为你在 .env 文件中配置的 NS API 密钥,与上方 .env 文件中的值保持一致
      }
    }
  }
}

请注意:

  • '"command"' 指定了启动服务器的命令,这里是 'node'。
  • '"args"' 是一个数组,包含了传递给命令的参数。你需要将 '/path/to/r-huijts_ns-mcp-server/build/index.js' 替换为 服务器 'build/index.js' 文件的实际绝对路径
  • '"env"' 定义了服务器运行所需的环境变量,'NS_API_KEY' 应该与你在 '.env' 文件中设置的 API 密钥一致。

基本使用方法

配置完成后,启动MCP客户端,客户端将自动连接到此MCP服务器。您可以通过客户端的功能调用以下工具,获取荷兰铁路相关信息:

  • 'get_disruptions': 查询列车延误信息。
  • 'get_travel_advice': 获取出行建议,需要提供出发站和到达站等信息。
  • 'get_departures': 查询车站出发信息,需要提供车站名称。

具体的工具参数和使用方式,请参考每个工具的 'description' 和 'inputSchema' 定义,或查阅项目代码中的 'src/index.ts' 文件。

信息

分类

网页与API