🚀 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 以确保其识别最新构建。