AI导哈

Fitbit健康数据连接器

连接AI助手与Fitbit健康数据，提供个性化健康分析、趋势追踪和自动化报告功能。

  • by TheDigitalNinja
  • TypeScript
  • 本地部署
  • 34 星标
  • 更新于
在 GitHub 查看 TheDigitalNinja/mcp-fitbit

使用说明

Fitbit人工智能MCP连接器

将AI助手连接到您的Fitbit健康数据

让您的AI助手访问您的Fitbit数据，以获得个性化的健康见解、趋势分析和自动跟踪。与Claude Desktop和其他MCP兼容的AI工具配合使用。

它做什么

🏃 锻炼和活动 -获取详细的锻炼日志和活动数据
😴 睡眠分析 -检索睡眠模式和质量指标
⚖️ 重量追踪 -访问权重随时间的变化趋势
❤️ 心率数据 -监测心率模式和区域
🍎 营养日志 -检查食物摄入量、卡路里和宏量
👤 个人资料信息 -访问Fitbit基本配置文件详细信息

问你的人工智能一些事情，比如：“本周给我看看我的睡眠模式”或“我锻炼时的平均心率是多少？”

快速开始

🚀 想立即测试工具吗？

选项1：从npm安装（推荐）

  1. 获取Fitbit API证书

    • 使用OAuth 2.0应用程序类型创建应用程序： Personal
    • 设置回调URL: http://localhost:3000/callback
    • 注意你的 客户端ID 和 客户端密钥

  2. 全局安装软件包：

npm install -g mcp-fitbit
  1. 添加到您的Claude Desktop配置文件中：
{
  "mcpServers": {
    "fitbit": {
      "command": "mcp-fitbit",
      "args": [],
      "env": {
        "FITBIT_CLIENT_ID": "your_client_id_here",
        "FITBIT_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}
  • 配置文件位置：
    • Windows：%AppData%\Claude\Claude_desktop_config json
    • macOS：~/库/应用程序支持/Claude/Claude_desktop_config json
    • Linux:~/.config/Claude/Claude_desktop_config json
  1. 重新启动Claude Desktop并询问您的Fitbit数据！

选项2：开发设置

  1. 获取Fitbit API证书 （见下文安装）
  2. 然后运行：
git clone https://github.com/TheDigitalNinja/mcp-fitbit
cd mcp-fitbit
npm install
# Create .env with your Fitbit credentials
npm run dev

这两个选项都打开了 MCP检查员 在 http://localhost:5173 在那里，您可以交互式地测试所有工具并处理OAuth流。

安装

面向终端用户（npm包）

  1. 获取Fitbit API证书 在 dev.fitbit.com

    • 集 OAuth 2.0应用程序类型 向 Personal
    • 集 回调URL 向 http://localhost:3000/callback

  2. 安装软件包：

    npm install -g mcp-fitbit

  3. 创建 .env 包目录中的文件：

    当你奔跑时 mcp-fitbit 这是第一次，它会告诉你在哪里创建 .env 文件。它看起来像：

    C:\Users\YourName\AppData\Roaming\npm\node_modules\mcp-fitbit\.env

  4. 将您的凭据添加到 .env 文件：

    FITBIT_CLIENT_ID=your_client_id_here
FITBIT_CLIENT_SECRET=your_client_secret_here

  5. 运行服务器：

    mcp-fitbit

开发者（来源）

  1. 获取Fitbit API证书 在 dev.fitbit.com

    • 集 OAuth 2.0应用程序类型 向 Personal
    • 集 回调URL 向 http://localhost:3000/callback

  2. 克隆和设置：

    git clone https://github.com/TheDigitalNinja/mcp-fitbit
cd mcp-fitbit
npm install

  3. 创建 .env 文件：

    FITBIT_CLIENT_ID=your_client_id_here
FITBIT_CLIENT_SECRET=your_client_secret_here

  4. 构建服务器：

    npm run build

可用工具

工具 说明 参数
get_weight 不同时间段的重量数据 period: 1d, 7d, 30d, 3m, 6m, 1y
get_sleep_by_date_range 日期范围的睡眠日志（最多100天） startDate, endDate （年-月-日）
get_exercises 日期后的活动/锻炼日志 afterDate （YYYY-MM-DD）， limit (1-100)
get_daily_activity_summary 每日活动总结及目标 date （年-月-日）
get_activity_goals 用户的活动目标（每日/每周） period: daily, weekly
get_activity_timeseries 活动时间序列数据（最多30天） resourcePath, startDate, endDate （年-月-日）
get_azm_timeseries 活动区分钟时间序列（最多1095天） startDate, endDate （年-月-日）
get_heart_rate 一段时间内的心率 period: 1d, 7d, 30d, 1w, 1m，可选 date
get_heart_rate_by_date_range 日期范围内的心率（最多1年） startDate, endDate （年-月-日）
get_food_log 一天的完整营养数据 date （YYYY-MM-DD或“今天”）
get_nutrition 随着时间的推移，个体营养素 resource, period，可选 date
get_nutrition_by_date_range 日期范围内的个体营养素 resource, startDate, endDate
get_profile 用户资料信息 无

营养资源： caloriesIn, water, protein, carbs, fat, fiber, sodium

活动时间序列资源： steps, distance, calories, activityCalories, caloriesBMR, tracker/activityCalories, tracker/calories, tracker/distance

克劳德桌面

使用npm包（推荐）：

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "fitbit": {
      "command": "mcp-fitbit",
      "args": []
    }
  }
}

使用本地开发版本：

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "fitbit": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-fitbit\\build\\index.js"]
    }
  }
}

配置文件位置：

  • 窗户： %AppData%\Claude\claude_desktop_config.json
  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json

首次运行授权

当你第一次要求你的AI助手使用Fitbit数据时：

  1. 服务器打开您的浏览器 http://localhost:3000/auth
  2. 登录Fitbit并授予权限
  3. 您将被重定向到成功页面
  4. 您的AI现在可以访问您的Fitbit数据！

发展

npm run lint          # Check code quality
npm run format        # Fix formatting
npm run build         # Compile TypeScript
npm run dev           # Run with MCP inspector

架构： 看 TASKS.md 了解改进机会和技术细节。

相关 MCP