使用说明
项目简介
本项目是一个MCP服务器,旨在为LLM客户端提供访问荷兰铁路(NS)实时出行信息的能力。通过集成NS API,该服务器提供了一系列工具,帮助用户查询列车延误、获取出行建议以及车站的实时出发信息。
主要功能点
- 查询列车延误 (get_disruptions): 获取当前荷兰铁路网络中的所有列车延误信息,可以根据延误类型和活动状态进行筛选。
- 获取出行建议 (get_travel_advice): 根据出发站和到达站,查询最优的列车出行方案,并可指定出发或到达时间。
- 查询车站出发信息 (get_departures): 获取指定车站的实时列车出发列表,包括列车方向、预计发车时间等信息。
安装步骤
- 克隆仓库:
git clone https://github.com/MCP-Mirror/r-huijts_ns-mcp-server.git - 进入项目目录:
cd r-huijts_ns-mcp-server - 安装依赖:
npm install - 复制环境变量示例文件:
cp .env.example .env - 配置 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