SNCF API MCP Server

基本能力

产品定位

SNCF API MCP Server 是一个为法国国家铁路（SNCF）API 提供模块化 Python 封装的 MCP 服务器接口，可与 Claude Desktop 无缝集成，用于智能旅程规划和法国范围内的列车信息检索。

核心功能

• 智能旅程规划：在法国任何城市之间规划行程，自动选择车站
• 全面的车站详情：获取车站的详细信息，包括可用的交通类型（火车、公交车、电车）、附近地点和兴趣点、坐标和可访问性信息
• 实时时刻表：访问最新的出发和到达信息
• 中断监控：了解服务中断情况
• 智能车站查找：通过城市名称、车站名称或坐标定位车站
• 回退机制：为法国主要城市提供硬编码坐标，确保即使 API 搜索失败也能可靠运行
• 详细日志记录：全面的日志记录，用于调试和监控

适用场景

• 规划法国城市间的火车旅行
• 获取火车站的详细信息
• 检查出发和到达的时刻表
• 监控服务中断
• 查找附近地点和交通选项

工具列表

• Journey Planning
• plan_journey_by_city_names：规划法国两个城市之间的旅程
• Station Information
• get_station_details：获取城市中火车站的详细信息
• get_station_schedule：获取车站的出发和到达时刻表
• Disruption Monitoring
• check_disruptions：检查 SNCF 交通网络中的当前中断

常见问题解答

• "No API key provided"：确保已将 SNCF API 密钥添加到 Claude Desktop 配置中
• "No stations found for city"：尝试使用更具体的城市名称
• "Failed to connect to SNCF API"：检查互联网连接，验证 API 密钥是否有效
• "Error initializing CSV station finder"：确保 train_stations_europe.csv 文件位于正确位置

使用教程

使用依赖

• Python 3.6+
• pip (Python 包管理器)

安装教程

1. 克隆仓库

git clone https://github.com/yourusername/sncf-mcp-new.git
cd sncf-mcp-new

1. 安装依赖

pip install -r requirements.txt

如果缺少 requirements.txt 文件，安装以下包：

pip install requests pandas mcp

调试方式

1. 确保已正确配置 Claude Desktop
2. 检查 API 密钥是否正确设置
3. 验证网络连接
4. 检查日志文件以获取调试信息

许可证

该项目遵循 MIT 开源许可条款。