SNCF API MCP Server

This project provides a modular Python wrapper for the SNCF API, with an MCP server interface that integrates seamlessly with Claude Desktop for intelligent journey planning and train information retrieval across France.

Table of Contents

• Overview
• Features
• Installation
• Getting an API Key
• Configuration
  • Setting Up Claude Desktop
  • Environment Variables
• Available MCP Tools
  • Journey Planning
  • Station Information
  • Disruption Monitoring
• Usage Examples
• Troubleshooting
• Advanced Features

Overview

The SNCF MCP Server provides a comprehensive interface to the French National Railway’s (SNCF) API services, allowing you to:

• Plan train journeys between cities in France
• Get detailed information about train stations
• Check schedules for departures and arrivals
• Monitor service disruptions
• Find nearby places and transport options

The structure is organized as follows:

• sncf_api/ - The main package for SNCF API interaction
  • __init__.py - Package initialization
  • config.py - Configuration settings
  • client.py - Base API client
  • api.py - Main API interface combining all modules
  • search.py - Search-related endpoints
  • journey.py - Journey planning endpoints
  • stations.py - Station-related endpoints
  • networks.py - Network and transport mode endpoints
  • disruptions.py - Disruption-related endpoints
  • station_finder.py - Efficient station lookup by coordinates
  • csv_station_finder.py - Station lookup using CSV database
  • vehicle_journey.py - Detailed train journey information
• sncf_server.py - MCP server implementation with all tool endpoints
• train_stations_europe.csv - Database of European train stations with coordinates

Features

• Intelligent Journey Planning: Plan trips between any cities in France with automatic station selection
• Comprehensive Station Details: Get detailed information about stations including:
  • Available transport types (trains, buses, trams)
  • Nearby places and points of interest
  • Coordinates and accessibility information
• Real-time Schedules: Access up-to-date departure and arrival information
• Disruption Monitoring: Stay informed about service disruptions
• Smart Station Finding: Locate stations by city name, station name, or coordinates
• Fallback Mechanisms: Hardcoded coordinates for major cities ensure reliability even when API searches fail
• Detailed Logging: Comprehensive logging for debugging and monitoring

Installation

Prerequisites

• Python 3.6+
• pip (Python package manager)

Step 1: Clone the Repository