Ns MCP Server

🚀 NS Travel Information MCP Server

Transform your AI assistant into a Dutch Railways expert! This MCP server connects Claude with real-time NS (Nederlandse Spoorwegen) travel information, making it your ideal companion for train travel in the Netherlands.

🚀 Quick Start

This MCP server can transform your AI assistant into an expert on Dutch Railways by connecting Claude with real - time NS travel information.

✨ Features

• Real - time Train Information: Get the latest train schedules, delays, and cancellation information.
• Station Details: View station facilities, accessibility information, and OV - fiets (bike rental) availability.
• Fare Information: Compare fares for different travel classes (first and second class) and enjoy group discounts and offers.

📦 Installation

You can install this server in three ways:

1. Using the NPM Package with Claude Desktop Version

Update your Claude configuration file (~/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"
      }
    }
  }
}

You can obtain an API key at the NS API Portal.

2. Using Smithery

Automatically install the NS Travel Information Server via Smithery:

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

3. Installing from Source Code

1. Clone this repository.
2. Install dependencies:

   npm install
   

3. Copy the example environment file:

   cp .env.example .env
   

4. Add your NS API key to the .env file:

   NS_API_KEY=your_api_key_here
   

Then update your Claude configuration file:

{
  "mcpServers": {
    "ns-server": {
      "command": "node",
      "args": [
        "./ns-mcp-server"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

🔧 Technical Details

Environment Variables

💻 Usage Examples

Basic Usage

# Example: Query real - time train information
curl -X POST http://localhost:7001/ns-train-info \
     -H "Content-Type: application/json" \
     -d '{"station":"Amsterdam"}'

📄 License

This project is under the MIT license. See the LICENSE file for details.