Taxuspt/garmin_mcp

解決的問題

本專案提供了一個模型上下文協定（MCP）伺服器，讓 AI 助理（例如 Claude）能夠與 Garmin Connect 互動。它填補了您的健身與健康資料和大型語言模型（LLM）之間的鴻溝，使它們能夠分析您的鍛鍊紀錄、追蹤健康指標，甚至直接在聊天介面中建立並排定訓練計畫。

運作方式

該伺服器扮演了相容 MCP 的用戶端與 Garmin Connect API（透過 python-garminconnect 函式庫）之間的中介角色。它提供了超過 110 個工具供 AI 呼叫，以擷取資料或執行操作。它支援多種傳輸方式，包含用於本地用戶端的標準輸入/輸出（stdio），以及用於遠端部署的 HTTP/SSE。

適用對象

健身愛好者、運動員以及 Garmin 裝置的使用者，希望能利用 AI 來分析其健康資料、管理訓練時程，並自動化鍛鍊項目的建立流程。

特色

• 豐富的工具集：實作了 110 多種工具，涵蓋活動管理、健康與保健、訓練表現以及營養。
• 鍛鍊建立器：提供高階工具來建立走/跑間歇訓練、Z2 步行與肌力訓練，無需使用原始 JSON。
• 一鍵安裝：支援 .dxt 副檔名檔案，可輕鬆安裝至 Claude Desktop。
• 進階分析：可存取功率區間、FIT 檔案分析以及訓練負荷趨勢（CTL/ATL/TSB）。
• 彈性配置：能夠將特定工具加入允許清單或拒絕清單，以減少 LLM 上下文視窗的使用量。