Ns Reiseinformationen Mcp Server

Was ist der ns-mcp-server?

Der ### ns-mcp-server ist ein Model Context Protocol (MCP) Server, der entwickelt wurde, um den Zugriff auf Echtzeit-Reiseinformationen der niederländischen Eisenbahnen (NS) über Claude AI zu ermöglichen. Dieser innovative Server ermöglicht es den Nutzern, aktuelle Fahrpläne, Reiseunterbrechungen und andere wichtige Reisedaten über die offizielle NS-API abzurufen. Er fungiert als Brücke zwischen den Nutzern und der Vielzahl von Reiseinformationen, die von den niederländischen Eisenbahnen verfügbar sind, und verbessert das Reiseerlebnis durch sofortigen Zugriff auf kritische Daten.

Funktionen des ns-mcp-server

• Echtzeit-Datenzugriff: Der Server verbindet sich mit der offiziellen NS-API und stellt sicher, dass die Nutzer die aktuellsten Reiseinformationen erhalten.
• Integration mit Claude AI: Durch die Nutzung von Claude AI kann der Server Benutzeranfragen interpretieren und relevante Reiseinformationen nahtlos bereitstellen.
• Benutzerfreundliche Oberfläche: Der Server ist benutzerfreundlich gestaltet und ermöglicht es den Nutzern, einfach auf Fahrpläne und Unterbrechungen zuzugreifen.
• Open Source: Der ns-mcp-server ist öffentlich verfügbar und fördert die Zusammenarbeit und Beiträge von Entwicklern aus der ganzen Welt.

So verwenden Sie den ns-mcp-server

1. Installation: Klonen Sie das Repository von GitHub mit dem Befehl:

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

2. Einrichtung: Befolgen Sie die Installationsanweisungen, die in der README-Datei des Repositories bereitgestellt werden, um den Server auf Ihrem lokalen Computer einzurichten.
3. API-Zugriff: Nutzen Sie den Server, um Anfragen an die NS-API zu stellen. Sie können Anfragen über Claude AI senden, um Echtzeit-Reiseinformationen abzurufen.
4. Funktionen erkunden: Experimentieren Sie mit verschiedenen Anfragen, um die vollständigen Möglichkeiten des Servers zu verstehen und wie er bei der Reiseplanung helfen kann.

Häufig gestellte Fragen

In welcher Programmiersprache ist der ns-mcp-server geschrieben?

Der ns-mcp-server ist hauptsächlich in JavaScript geschrieben, was ihn für Entwickler zugänglich macht, die mit Webtechnologien vertraut sind.

Gibt es Kosten für die Nutzung des ns-mcp-server?

Nein, der ns-mcp-server ist Open Source und kostenlos zu verwenden. Nutzer sollten jedoch auf etwaige Nutzungsbeschränkungen oder Bedingungen achten, die von der offiziellen NS-API festgelegt sind.

Kann ich zum Projekt ns-mcp-server beitragen?

Absolut! Beiträge sind willkommen. Sie können Probleme, Funktionsanfragen oder Pull-Requests im GitHub-Repository einreichen.

Wie kann ich einen Fehler oder ein Problem mit dem Server melden?

Sie können Fehler oder Probleme melden, indem Sie ein Issue im GitHub-Repository eröffnen. Stellen Sie sicher, dass Sie detaillierte Informationen über das aufgetretene Problem bereitstellen.

Wo finde ich die Dokumentation für den ns-mcp-server?

Die Dokumentation befindet sich in der Regel in der README-Datei des Repositories, zusammen mit Kommentaren im Code selbst. Für detailliertere Anleitungen können Sie auch die Bereiche für Probleme und Diskussionen auf GitHub überprüfen.

| <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