Ns Travel Information Mcp Server

What is ns-mcp-server?

The ### ns-mcp-server is a Model Context Protocol (MCP) server designed to provide access to real-time travel information from the Dutch Railways (NS) through Claude AI. This innovative server allows users to fetch up-to-date train schedules, travel disruptions, and other essential travel data using the official NS API. It serves as a bridge between users and the vast array of travel information available from the Dutch Railways, enhancing the travel experience with immediate access to critical data.

Features of ns-mcp-server

• Real-Time Data Access: The server connects to the official NS API, ensuring that users receive the most current travel information.
• Integration with Claude AI: By leveraging Claude AI, the server can interpret user queries and provide relevant travel information seamlessly.
• User-Friendly Interface: Designed with usability in mind, the server allows users to easily access train schedules and disruptions.
• Open Source: The ns-mcp-server is publicly available, encouraging collaboration and contributions from developers around the world.

How to Use ns-mcp-server

1. Installation: Clone the repository from GitHub using the command:

   git clone https://github.com/r-huijts/ns-mcp-server.git
   

2. Setup: Follow the installation instructions provided in the repository's README file to set up the server on your local machine.
3. API Access: Utilize the server to make requests to the NS API. You can send queries through Claude AI to retrieve real-time travel information.
4. Explore Features: Experiment with different queries to understand the full capabilities of the server and how it can assist with travel planning.

Frequently Asked Questions

What programming language is ns-mcp-server built with?

The ns-mcp-server is primarily built using JavaScript, making it accessible for developers familiar with web technologies.

Is there any cost associated with using ns-mcp-server?

No, the ns-mcp-server is open-source and free to use. However, users should be aware of any usage limits or terms set by the official NS API.

Can I contribute to the ns-mcp-server project?

Absolutely! Contributions are welcome. You can submit issues, feature requests, or pull requests on the GitHub repository.

How can I report a bug or issue with the server?

You can report bugs or issues by opening an issue on the GitHub repository. Be sure to provide detailed information about the problem you encountered.

Where can I find documentation for ns-mcp-server?

Documentation is typically found in the repository's README file, along with comments in the code itself. For more detailed guidance, you can also check the issues and discussions sections on GitHub.

| <img src="https://upload.wikimedia.org/wikipedia/commons/b/b7/Nederlandse_Spoorwegen_logo.svg" alt="NS Logo" width="380"/> | <img src="https://glama.ai/mcp/servers/tzd5oz5tov/badge" alt="NS Travel Information Server MCP server" width="380"/> | |::|::|

NS Travel Information MCP Server

Transform your AI assistant into a Dutch railways expert! This MCP server connects Claude to real-time NS (Nederlandse Spoorwegen) travel information, making it your perfect companion for navigating the Netherlands by train.

Installation

You can install this server in three ways:

1. Using Claude Desktop with NPM Package

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 get an API key from NS API Portal

2. Using Smithery

To install NS Travel Information Server automatically via Smithery:

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

3. From Source

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": [
        "/path/to/ns-server/build/index.js"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Make sure to:

1. Replace /path/to/ns-server with the actual path to your installation
2. Add your NS API key in the env section. It can be obtained from here https://apiportal.ns.nl/product#product=NsApp

After updating the configuration, restart Claude Desktop for the changes to take effect.

Real-World Use Cases

• "Is my usual 8:15 train from Almere to Amsterdam running on time?"
• "Are there any delays on the Rotterdam-Den Haag route today?"
• "What's the best alternative route to Utrecht if there's maintenance on the direct line?"
• "Which train should I take to arrive at my office in Amsterdam Zuid before 9 AM?"
• "Which route to Amsterdam has the fewest transfers with a stroller?"
• "What's the earliest train I can take to make my 10 AM meeting in The Hague?"
• "When's the last train back to Groningen after a night out in Amsterdam?"
• "Are there any weekend engineering works that might affect my Monday morning class?"
• "Are there OV-fiets bikes available at Utrecht Centraal for my afternoon meeting?"
• "Is Eindhoven Strijp-S station wheelchair accessible and what platforms does it have?"
• "What trains are arriving at Utrecht Centraal in the next hour?"
• "Has the train from Venlo to Schiphol Airport arrived on time?"
• "How much does a first-class ticket from Amsterdam to Rotterdam cost?"
• "What's the price for 2 adults and 1 child traveling to Den Haag?"

🔑 Environment Variables

Variable	Description
NS_API_KEY	Your NS API key (required)

🌟 Features

This MCP server provides comprehensive access to NS train information through the following endpoints:

Real-time Train Information

• Departures: Get real-time departure information including platform numbers, delays, and travel notes
• Arrivals: Access upcoming train arrivals with origin stations, platform changes, and status updates
• Journey Planning: Find optimal travel routes with transfers and real-time updates
• Service Updates: Check for disruptions, maintenance work, and engineering activities

Pricing Information

• Ticket Prices: Get accurate pricing for single and return journeys
• Travel Classes: Compare prices for first and second class travel
• Group Pricing: Calculate fares for adults and children
• Discount Options: Check joint journey discounts and special offers
• Validity Details: View ticket validity periods and travel conditions

Station Information

• Station Details: Access comprehensive station information including:
  • Facilities and accessibility features
  • Platform layouts and track information
  • OV-fiets (bike rental) availability
  • Location and approach details

Additional Features

• Multi-language Support: Information available in Dutch and English
• Flexible Queries: Search by station name, code, or UIC identifier
• Time Zones: Proper handling of time zones for international stations
• Status Updates: Track changes, delays, and cancellations in real-time

License

This project is licensed under the MIT License - see the LICENSE file for details