SNCF 跨運輸协调服務器

目錄

• 概況
• 安裝與配置
• 功能模塊
• 使用示例
• 故障排除
• 高級特性
• 貢獻指南
• 授權信息
• 致謝

概況

本項目旨在為 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 工具用於報告問題。

使用示例

示例 1：規劃火車行程

# 初始化伺服器
mcp_server = SNCFMCP_Server(api_key="your_api_key")

# 計劃從巴黎到馬賽的行程
journey = mcp_server.plan_journey(from_city="Paris", to_city="Marseille")
print(journey.details)

示例 2：查詢站點信息

# 初始化伺服器
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. 多語言支持

• 支持多種語言的行程規劃和報告，包括英語、法語和其他歐洲語言。

2. 整合第三方服務

• 支持與其他交通方式（如公共汽車、飛機）的數據交換。

3. 自動化干預

• 根據實時數據自動檢測並報告服務中斷情況。
• 提供可定制的通知系統。

貢獻指南

如何貢獻

1. 提交 issue 報告問題或提出改进建議。
2. 提交.Pull Request 提交代碼修改或功能增強。
3. 參與文檔編寫和本地化工作。

授权信息

本項目遵守 MIT 協議授權，具體條款請參閱LICENSE文件。

致謝

感謝以下人員和機構的支持：

• SNCF 開發團隊
• Claude AI 團隊
• 全球オープンデータコミュニティ