Fitbit

🚀 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 環境中，請按以下步驟操作：

1. 把構建好的 dist 文件夾中的文件添加到 Claude 的工具路徑中。
2. 在 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": {}
    }
  ]
}

🔧 技術細節

開發

• 源代碼存於 src/ 目錄。
• 修改 TypeScript 文件後，需運行 npm run build 進行構建。
• 若服務器已在 Claude 環境下運行，重啟 Claude 以確保其識別最新構建。