🚀 SNCF 跨运输协调服务器

本项目为 SNCF（法国国家铁路公司）的多式联运服务打造了强大的技术架构。它与 Claude AI 深度集成，能智能规划火车、公交等交通行程，还可提供实时信息与干预功能。

🚀 快速开始

本项目旨在为 SNCF 的多式联运服务提供强大的技术支持，通过与 Claude AI 深度集成，实现交通行程的智能规划与实时信息服务。以下是使用前的安装与配置步骤。

📦 安装指南

安装步骤

1. 下载并安装最新版本的 SNCF 多式联运协调服务器（MCP Server）。
2. 将 SNCF 提供的 API 密钥添加到系统环境变量中。
3. 复制 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)

🔧 技术细节

常见问题

1. API 连接错误：
   • 确保 API 密钥有效且正确配置。
2. 数据库错误：
   • 检查 CSV 文件的完整性，确保其权限设置正确。

排错指南

• 查看服务器日志以获取具体错误信息。
• 使用 --verbose 标志启用详细 Debugging 模式。

🤝 贡献指南

如何贡献

1. 提交 issue 报告问题或提出改进建议。
2. 提交.Pull Request 提交代码修改或功能增强。
3. 参与文档编写和本地化工作。

📄 许可证

本项目遵守 MIT 协议授权，具体条款请参阅 LICENSE 文件。

🙏 致谢

感谢以下人员和机构的支持：

• SNCF 开发团队
• Claude AI 团队
• 全球开放数据社区