MCP Sncf

🚀 SNCF Inter - transport Coordination Server

This project aims to provide a robust technical architecture for SNCF's (French National Railway Company) intermodal transport services. The system is deeply integrated with Claude AI, capable of intelligently planning train, bus, and other transportation routes, and offering real - time information and intervention functions.

🚀 Quick Start

The SNCF Inter - transport Coordination Server is designed to streamline the planning and management of multi - modal transportation. It offers a comprehensive set of tools for journey planning, station information query, and service interruption reporting.

✨ Features

1. Train Journey Planning

• Use the plan_journey_by_city_names tool to plan the best train routes based on city names.
• Support complex transfer requirements and provide real - time ticketing information.

2. Station Information Query

• Query basic information about specific stations, available transportation modes (such as trains, buses, trams), and surrounding facilities.
• Obtain detailed information through the get_station_details tool.

3. Train Schedule Query

• Use the get_station_schedule tool to view upcoming train schedules at specific stations.
• Support real - time updates and platform details display.

4. Service Intervention and Troubleshooting

• Check and report any interventions or disruptions in train services or facilities.
• Provide the report_service_interruption tool for reporting problems.

5. Multilingual Support

• Support journey planning and reporting in multiple languages, including English, French, and other European languages.

6. Third - Party Service Integration

• Support data exchange with other transportation modes (such as buses and airplanes).

7. Automated Intervention

• Automatically detect and report service disruptions based on real - time data.
• Provide a customizable notification system.

📦 Installation

Installation Steps

1. Download and install the latest version of the SNCF Multimodal Coordination Server (MCP Server).
2. Add the API key provided by SNCF to the system environment variables.
3. Copy the train_stations_europe.csv file to the server directory and ensure its permissions are set correctly.

Server Configuration

• API Key: Specify a valid SNCF API key during the initialization process.
• CSV Station Data: By default, use the European railway station database, and support custom expansion.
• Logging Settings: Enable detailed logging to track operations and errors.

💻 Usage Examples

Basic Usage

# Initialize the server
mcp_server = SNCFMCP_Server(api_key="your_api_key")

# Plan a journey from Paris to Marseille
journey = mcp_server.plan_journey(from_city="Paris", to_city="Marseille")
print(journey.details)

Advanced Usage

# Initialize the server
mcp_server = SNCFMCP_Server(api_key="your_api_key")

# Query basic information about Lyon station
station_info = mcp_server.get_station_details(station_id=" Lyon ")
print(station_info.facilities)

📚 Documentation

Troubleshooting

Common Issues

1. API Connection Error:
   • Ensure that the API key is valid and correctly configured.
2. Database Error:
   • Check the integrity of the CSV file and ensure its permissions are set correctly.

Troubleshooting Guide

• Check the server logs for specific error information.
• Use the --verbose flag to enable detailed debugging mode.

Contribution Guide

How to Contribute

1. Submit an issue to report problems or propose improvement suggestions.
2. Submit a Pull Request to submit code modifications or feature enhancements.
3. Participate in documentation writing and localization work.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for specific terms.

Acknowledgments

Thanks to the support of the following individuals and organizations:

• SNCF Development Team
• Claude AI Team
• Global Open Data Community