🚀 SNCF 跨运输协调服务器
本项目为 SNCF（法国国家铁路公司）的多式联运服务打造了强大的技术架构。它与 Claude AI 深度集成，能智能规划火车、公交等交通行程，还可提供实时信息与干预功能。
🚀 快速开始
本项目旨在为 SNCF 的多式联运服务提供强大的技术支持，通过与 Claude AI 深度集成，实现交通行程的智能规划与实时信息服务。以下是使用前的安装与配置步骤。
📦 安装指南
安装步骤
- 下载并安装最新版本的 SNCF 多式联运协调服务器（MCP Server）。
- 将 SNCF 提供的 API 密钥添加到系统环境变量中。
- 复制
train_stations_europe.csv文件到服务器目录，并确保其权限设置正确。
服务器配置
- API 密钥：在初始化过程中指定有效的 SNCF API 密钥。
- CSV 站点数据：默认使用欧洲铁路站点数据库，支持自定义扩展。
- 日志设置：启用详细日志记录以跟踪操作和错误。
✨ 主要特性
1. 火车行程规划
- 使用
plan_journey_by_city_names工具根据城市名称规划最佳火车路线。 - 支持复杂的转机需求，并提供实时票务信息。
2. 站点信息查询
- 查询特定站点的基本信息、可用交通方式（如火车、公共汽车、有轨电车）以及周边设施。
- 可通过
get_station_details工具获取详细信息。
3. 列车班次查询
- 使用
get_station_schedule工具查看特定站点的 upcoming 和 upcoming 火车班次。 - 支持实时更新和平台细节显示。
4. 服务干预与故障排除
- 检查并报告火车服务或设施的任何干预或中断情况。
- 提供
report_service_interruption工具用于报告问题。
5. 高级特性
多语言支持
支持多种语言的行程规划和报告，包括英语、法语和其他欧洲语言。
整合第三方服务
支持与其他交通方式（如公共汽车、飞机）的数据交换。
自动化干预
- 根据实时数据自动检测并报告服务中断情况。
- 提供可定制的通知系统。
💻 使用示例
基础用法
# 初始化服务器
mcp_server = SNCFMCP_Server(api_key="your_api_key")
# 计划从巴黎到马赛的行程
journey = mcp_server.plan_journey(from_city="Paris", to_city="Marseille")
print(journey.details)
高级用法
# 初始化服务器
mcp_server = SNCFMCP_Server(api_key="your_api_key")
# 查询里昂站的基本信息
station_info = mcp_server.get_station_details(station_id=" Lyon ")
print(station_info.facilities)
🔧 技术细节
常见问题
- API 连接错误：
- 确保 API 密钥有效且正确配置。
- 数据库错误：
- 检查 CSV 文件的完整性，确保其权限设置正确。
排错指南
- 查看服务器日志以获取具体错误信息。
- 使用
--verbose标志启用详细 Debugging 模式。
🤝 贡献指南
如何贡献
- 提交 issue 报告问题或提出改进建议。
- 提交.Pull Request 提交代码修改或功能增强。
- 参与文档编写和本地化工作。
📄 许可证
本项目遵守 MIT 协议授权，具体条款请参阅 LICENSE 文件。
🙏 致谢
感谢以下人员和机构的支持：
- SNCF 开发团队
- Claude AI 团队
- 全球开放数据社区