Where Is My Train MCP

🚀 我的列車在哪裡？MCP 服務器

這是一個用於獲取紐約市地鐵即時信息的 MCP 服務器。它藉助人工智能/大語言模型（AI/LLM）的地理知識實現智能位置處理，並結合紐約大都會運輸署（MTA）的即時數據，為車站、列車到站信息、警報和服務狀態等提供結構化的 JSON 數據。

數據來自紐約大都會運輸署（MTA） • 僅供個人使用 • 未得到 MTA 的認可 • 數據“按原樣”提供

🚀 快速開始

快速示例

• “我的列車在哪裡？我在德卡爾布大道站找 Q 線列車”

✨ 主要特性

• 即時列車到站信息：包含擁擠程度信息
• 車站搜索：支持模糊匹配，並提供無障礙設施信息
• 服務警報：提供服務中斷分析
• 智能位置處理：人工智能可將位置名稱轉換為座標
• 附近車站查找：支持使用 GPS 座標或位置名稱查找
• 換乘信息：提供複雜線路的換乘信息
• 即時 MTA GTFS - RT 數據：涵蓋所有地鐵線路

📦 安裝指南

選項 1：在 Smithery 上使用（推薦）

即時訪問：訪問 smithery.ai/server/@sasabasara/where_is_my_train_mcp，點擊“安裝”，將其添加到您的 AI 客戶端。 無需設置，可立即與 Claude、ChatGPT、Cursor 等支持 MCP 的客戶端配合使用。

選項 2：本地運行

前提條件：

• Node.js 18+

快速啟動：

# 克隆並安裝
git clone <your-repo>
cd whereismytrain-mcp
npm install

# 啟動開發服務器（推薦）
npm run dev

# 或者啟動傳統 MCP 服務器
npm start

就這麼簡單！ 服務器在首次運行時會自動下載並緩存 MTA GTFS 數據。

💻 使用示例

基礎用法

可執行的操作

基於車站的查詢：

• 查找車站："查找時代廣場站"
• 查詢下一班列車："聯合廣場站的下一班列車"
• 查詢換乘信息："大西洋大道站的換乘信息"

系統信息查詢：

• 服務狀態和警報
• 即時服務中斷情況
• 列車擁擠數據

基於位置的搜索：

• 查找最近的車站："時代廣場附近的車站" 或 "蘇豪區附近的車站"
• 使用 GPS 座標：lat: 40.7589, lon: -73.9851
• 人工智能會自動將位置名稱轉換為座標

無法執行的操作（受 MTA 數據限制）

複雜行程規劃：

• ❌ 多模式交通（公交 + 地鐵組合）
• ❌ 考慮即時交通狀況的路線規劃
• ❌ 拼車服務集成
• ✅ 人工智能可鏈接工具進行基本的地鐵行程規劃

非地鐵交通：

• ❌ 公交線路和時刻表
• ❌ 長島鐵路（LIRR）、大都會北方鐵路（Metro - North）、新澤西交通局（NJ Transit）
• ❌ 渡輪、出租車、拼車信息
• ✅ 僅支持紐約市地鐵（所有線路：1 - 7、A - Z、區間車）

歷史/未來數據：

• ❌ 過去的服務表現
• ❌ 超過約 2 小時的時刻表
• ❌ 計劃中的服務變更（當前警報之外）
• ✅ 僅提供即時數據（當前狀況）

代碼示例

// 核心功能
next_trains("Union Square", "N")  // 聯合廣場站的 N 線列車
find_station("herald", true)      // 查找有無障礙設施的先驅廣場站
nearest_station({lat: 40.7589, lon: -73.9851})  // 使用 GPS 座標查找最近的車站
station_transfers("Atlantic Ave") // 大西洋大道站的換乘選項
service_status("Q")              // Q 線的服務狀態

// 人工智能增強查詢
"stations near Times Square"      // 人工智能將位置名稱轉換為座標
"how to get from SoHo to Brooklyn" // 人工智能鏈接多個工具進行行程規劃
"any service alerts for my commute?" // 人工智能進行上下文理解

📚 詳細文檔

工具介紹

核心工具

• next_trains：提供即時列車到站信息及擁擠程度指標
• find_station：支持模糊車站搜索，並提供無障礙設施信息
• nearest_station：查找最近的車站（人工智能可將位置名稱轉換為座標）
• station_transfers：提供車站的換乘選項

系統工具

• service_status：提供全系統或特定線路的服務狀態
• subway_alerts：提供詳細的服務警報，並支持過濾功能
• service_disruptions：進行服務中斷分析，並提供替代方案

🔧 技術細節

MTA 合規與使用條款

僅用於個人用途：此服務器專為個人非商業用途設計。

關鍵要求：

• ✅ 個人開發：允許直接訪問 MTA 數據饋送
• ❌ 公開分發：需要數據緩存服務器和 MTA 許可證
• 📋 需要註明來源：輸出中需包含“數據來自 MTA”
• 🚫 禁止重新分發原始數據饋送

數據免責聲明：

• 數據“按原樣”提供，不保證準確性
• 由於處理原因，數據可能存在延遲或不完整
• 與 MTA 無關聯，也未得到其認可

對於生產/公開使用，您必須實施適當的數據緩存基礎設施並獲得 MTA 許可。

部署方式

Smithery（推薦）

npx @smithery/cli deploy

傳統 MCP

使用 npm start 通過標準輸入輸出協議與任何 MCP 客戶端配合使用。

數據來源

• 即時數據饋送：通過 MTA GTFS - RT 獲取紐約市所有地鐵線路的即時數據
• 靜態數據：車站、線路、換乘信息（自動下載）
• 服務警報：即時服務中斷和延誤信息
• 更新頻率：每 30 秒更新一次（即時數據）

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。