MCP Sncf

🚀 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 團隊
• 全球開放數據社區