Fitbit

該項目實現了一個Fitbit MCP服務器，作為LLM與Fitbit API之間的橋樑，支持通過定義的工具獲取用戶健康數據。

健康與養生開發者工具 .TypeScript

評分 : 2.5分

下載量 : 21

更新時間 : 2025-05-07

什麼是Fitbit MCP服務器？

Fitbit MCP服務器是一個安全的工具，它允許您通過Fitbit API獲取個人健康和健身數據，例如體重、睡眠記錄等。這些數據可以通過語言模型（如Claude）進行分析和利用。

如何使用Fitbit MCP服務器？

首先，您需要設置服務器並授權它訪問您的Fitbit賬戶。然後，您可以使用簡單的命令來請求所需的數據。

適用場景

該服務器適用於希望跟蹤健康指標、優化生活習慣以及分析個人健康數據的研究人員、健身愛好者或醫生。

主要功能

體重追蹤獲取過去一段時間內的體重變化趨勢。

睡眠記錄分析指定日期範圍內的睡眠質量與時長。

用戶資料獲取用戶的全面健康檔案，包括年齡、性別、身高和體重等。

更多功能正在開發中未來版本將支持步數統計、心率監測及活動分析等功能。

優勢與侷限性

優勢

輕鬆整合健康數據到AI分析中。

支持多種數據維度，滿足多樣化需求。

安全可靠的OAuth 2.0認證機制。

侷限性

僅限於已授權的Fitbit賬戶使用。

某些高級功能可能需要額外權限。

對網絡環境有一定依賴性。

如何使用

安裝與配置

按照指引安裝依賴項並創建環境文件以保存您的Fitbit憑據。

授權服務器

啟動服務器後，瀏覽器會自動打開授權頁面。登錄您的Fitbit賬戶並同意授權。

開始使用

在Claude中輸入命令即可調用對應功能。

使用案例

案例1：體重趨勢分析瞭解最近一個月內的體重波動情況。

案例2：睡眠質量評估分析4月份的睡眠質量是否有所改善。

案例3：獲取用戶檔案快速查看個人基本信息。

常見問題

如何確保數據的安全性？

是否支持多個Fitbit賬戶？

能否導出數據到Excel？

如果忘記密碼怎麼辦？

🚀 Fitbit 模型上下文協議 (MCP) 服務器

本項目實現了一個遵循模型上下文協議（MCP）的服務器，它在大型語言模型（如 Claude）和 Fitbit API 之間搭建了一座橋樑。藉助該服務器，大型語言模型能夠請求並獲取用戶 Fitbit 賬戶中的健康與健身數據，還能通過預定義的工具與之交互。

🚀 快速開始

克隆倉庫

git clone [倉庫地址]
cd fitbit-mcp-server

安裝依賴項

npm install

配置環境變量

創建一個 .env 文件，並添加以下內容：

FITBIT_CLIENT_ID=your_client_id
FITBIT_CLIENT_SECRET=your_client_secret

構建項目

npm run build

運行服務器

npm start

✨ 主要特性

Fitbit API 集成：利用 OAuth 2.0 安全地連接到 Fitbit API。
MCP 兼容性：通過符合模型上下文協議的工具提供 Fitbit 數據。
可擴展性：設計靈活，便於添加對更多 Fitbit API 端點的支持。

支持的端點

體重
- get_weight：以今天為結束日期，檢索指定時間段（1d、7d、30d、3m、6m、1y）內的原始體重數據。此方法需要一個 period 參數。
睡眠
- get_sleep_by_date_range：檢索指定日期範圍（最多 100 天）內的原始睡眠日誌數據。需要兩個參數：startDate 和 endDate，格式均為 YYYY-MM-DD。
個人資料
- get_profile：檢索用戶的 Fitbit 個人資料信息。

計劃中的端點

未來將支持更多 Fitbit API 端點，涵蓋但不限於：

活動數據
心率監測
血壓記錄
身高等等

📦 安裝指南

按照上述“快速開始”部分的步驟進行操作，即可完成服務器的安裝與配置。

💻 使用示例

基礎用法

以下是使用服務器提供工具的概念性示例：

# 獲取近 7 天的體重數據
get_weight(period="7d")

# 獲取 2025 年 4 月 1 日至 4 月 30 日的睡眠數據
get_sleep_by_date_range(startDate="2025-04-01", endDate="2025-04-30")

# 獲取用戶的 Fitbit 個人資料信息
get_profile()

📚 詳細文檔

與 Claude 集成

若要將此服務器集成到 Claude 環境中，請按以下步驟操作：

把構建好的 dist 文件夾中的文件添加到 Claude 的工具路徑中。
在 Claude 的配置文件（通常是 config.json）中添加以下內容：

{
  "tools": [
    {
      "name": "get_weight",
      "description": "獲取指定時間段內的體重數據。",
      "parameters": {
        "type": "object",
        "properties": {
          "period": {
            "type": "string",
            "enum": ["1d", "7d", "30d", "3m", "6m", "1y"],
            "description": "指定時間段。必須是 '1d'、'7d'、'30d'、'3m'、'6m' 或 '1y'。"
          }
        }
      }
    },
    {
      "name": "get_sleep_by_date_range",
      "description": "獲取指定日期範圍內的睡眠數據。",
      "parameters": {
        "type": "object",
        "properties": {
          "startDate": {
            "type": "string",
            "format": "date",
            "description": "開始日期，格式為 'YYYY-MM-DD'。"
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "結束日期，格式為 'YYYY-MM-DD'。"
          }
        }
      }
    },
    {
      "name": "get_profile",
      "description": "獲取用戶的 Fitbit 個人資料信息。",
      "parameters": {}
    }
  ]
}