使用说明
🚲 YouBike 助手 (mcp-tw-youbike)
這是一個基於 FastMCP 框架開發的 Model Context Protocol (MCP) 伺服器，支援查詢台灣各城市 YouBike 站點的即時車輛與空位。
✨ 特點
- 雙傳輸模式：同時支援
stdio(本機) 與streamable-http(遠端/Docker) 模式。 - 全台覆蓋：支援雙北、桃園、台中、台南、高雄等地的 YouBike 2.0 數據。
- 即時數據：整合 PTX (TDX) 官方即時 API。
🚀 傳輸模式 (Transport Modes)
1. 本機模式 (STDIO) - 預設
適合與 Claude Desktop 搭配使用。
python src/server.py --mode stdio
2. 遠端模式 (HTTP)
適合 Docker 部署與遠端存取。
python src/server.py --mode http --port 8000
- 服務 URL:
http://localhost:8000/mcp
🔌 客戶端配置範例
Claude Desktop (STDIO)
{
"mcpServers": {
"tw-youbike": {
"command": "python",
"args": ["/絕對路徑/src/server.py", "--mode", "stdio"]
}
}
}
Dive / HTTP 客戶端
- Type:
streamable - URL:
http://localhost:8000/mcp
