SNCF Train Journey Planner

🚀 SNCF 服務器指南

本指南詳細介紹瞭如何使用基於 Navitia 的 SNCF 公共交通 API 構建和配置一個 MCP（多式聯運協調平臺）服務器。MCP 服務器可協調多種運輸方式的整合，助力用戶規劃複雜的旅行路線。

🚀 快速開始

本指南將引導你完成基於 Navitia 的 SNCF 公共交通 API 的 MCP 服務器的構建與配置，以實現多種運輸方式的協調整合。

✨ 主要特性

• 站點搜索工具：支持基於 API 的站點查找和硬編碼座標查詢。
• 線路規劃工具：提供基本線路規劃和複雜行程優化功能，支持多目的地和時間窗口。
• 調度查詢工具：可查詢即時列車時刻表和歷史數據。
• 擾亂監控工具：能進行即時擾亂檢測和歷史擾亂分析。
• 硬編碼座標：系統內置法國主要城市的地理座標，保障網絡分區時可靠運行。
• 運輸類型分析：可分析和分類站點可用的運輸類型。
• 附近地點搜索：能查找站點附近的興趣點。

📦 安裝指南

安裝依賴項

1. Python 環境：需要 Python 3.8 或更高版本。
2. Navitia SDK：通過 pip 安裝 Navitia 的官方 SDK。

   pip install navitia-python
   

3. 地理數據文件：
   • 下載歐羅巴地區的火車站點 CSV 文件 train_stations_europe.csv。

服務器配置

1. 創建 MCP 配置文件：
   • 配置 Navitia 的應用 ID 和密鑰。

     NAVITIA_APP_ID = 'your_app_id'
     NAVITIA_APP_KEY = 'your_app_key'
     

2. 初始化數據庫：
   • 使用提供的 SQL 腳本創建必要的數據庫表。

     python init_db.py
     

💻 使用示例

基礎用法

站點搜索工具

# 基於 API 的站點查找
stations = find_stations_by_city('Paris')

# 硬編碼座標查詢
from hardcoded_coordinates import get_major_cities_coords
coords = get_major_cities_coords('Paris')  # (48.853, 2.348)

線路規劃工具

# 基本線路規劃
response = plan_journey('Paris', 'Marseille')
print(response.journeys)  # 輸出行程詳情

調度查詢工具

# 即時列車時刻表
schedule = get_train_schedule('Gare de Lyon', 'Paris')
print(schedule.upcoming_trains)

# 歷史數據檢索
historical_data = fetch_historical_schedule('Bordeaux', '2023-10-26T00:00/2023-10-27T23:59')

擾亂監控工具

# 即時擾亂檢測
disruptions = check_disruptions('Paris', 'Lyon')
for disruption in disruptions:
    print(disruption.impact, disruption.description)

# 歷史擾亂分析
historical_disruptions = get_historical_disruptions('Marseille', '2023-10-25T00:00/2023-10-27T23:59')

高級用法

線路規劃工具 - 複雜行程優化

# 支持多目的地和時間窗口
response = plan_complex_journey(['Marseille', 'Nice'], '2023-10-27T14:00')

📚 詳細文檔

硬編碼座標

系統內置了法國主要城市的地理座標，確保在網絡分區時仍能可靠運行：

• 巴黎 (48.853, 2.348)
• 馬賽 (43.303, 5.380)
• 里昂 (45.760, 4.860)
• 圖盧茲 (43.611, 1.454)
• 尼斯 (43.704, 7.262)
• 南特 (47.217, -1.542)
• 斯特拉斯堡 (48.585, 7.735)
• 波爾多 (44.826, -0.556)
• 利爾 (50.638, 3.072)
• 昆stras (48.103, -1.672)
• 格勒諾布爾 (45.192, 5.716)

運輸類型分析

get_station_details 工具可以分析和分類站點可用的運輸類型：

• 長途列車（TGV、Intercités）
• 區域列車（TER）
• 當地交通（公共汽車、有軌電車、地鐵）
• 其他服務（出租車、自行車共享）

附近地點搜索

站點詳細信息工具可以查找站點附近的興趣點：

• 其他交通停靠站
• 餐飲設施
• 旅遊景點
• 商業區域

🔧 技術細節

故障排除與維護

1. 錯誤處理：實現適當的異常捕捉和日誌記錄機制。
2. 性能優化：使用緩存技術減少重複查詢。
3. 監控工具：集成系統健康監測功能，及時發現並解決問題。

安全注意事項

1. 憑據管理：確保 Navitia 的應用 ID 和密鑰安全，避免洩露。
2. 網絡防護：使用 HTTPS 保障數據傳輸安全。
3. 訪問控制：實施身份驗證和授權機制，限制未授權訪問。

📄 許可證

本項目遵循 MIT 許可證，具體條款請參考 LICENSE 文件。

🔗 文檔與資源

• Navitia 官方文檔
• Python SDK 示例
• SNCF 數據規範

🤝 貢獻與支持

• 問題報告：在 GitHub 倉庫中提交 issue。
• 代碼貢獻： Fork 倉庫並提出 Pull Request。
• 社區支持： 加入相關技術論壇或 Slack 頻道。

📞 聯繫方式

如有任何問題或建議，請聯繫：

• 電子郵箱：support@sncf.com
• 電話：+33 1 23 45 67 89

⚠️ 重要提示

本指南中的代碼示例和配置細節僅供參考，實際使用中請根據具體需求調整。