Polar MCP (Mbentham)

极地健身MCP服务器

MCP服务器，将原始Polar设备数据转化为AI就绪的健身见解。运动样本、心率流、睡眠睡眠图和恢复指标被预处理成紧凑的摘要，因此人工智能助手可以在不破坏上下文窗口的情况下分析数天的健康数据。

快速开始

1.注册 在 管理员.polarraccesslink.com -创建一个新的API客户端，注意 client_id 和 client_secret，并将重定向URI设置为 https://localhost:8080/callback.

2.安装

npm install
npm run build

3.配置 --添加到您的MCP客户端（Claude Code settings.json克劳德桌面等）：

{
  "mcpServers": {
    "polar-accesslink": {
      "command": "node",
      "args": ["/path/to/polar-accesslink-mcp-server/dist/index.js"]
    }
  }
}

4.身份验证 --让Claude使用您的客户端ID生成您的授权URL，完成浏览器流程，然后将代码交换为访问令牌。将返回的凭据添加到您的配置中：

{
  "mcpServers": {
    "polar-accesslink": {
      "command": "node",
      "args": ["/path/to/polar-accesslink-mcp-server/dist/index.js"],
      "env": {
        "POLAR_ACCESS_TOKEN": "your_access_token",
        "POLAR_USER_ID": "your_user_id"
      }
    }
  }
}

5.注册您的用户 --重启后，让克劳德打电话 polar_register_user。在访问任何数据之前，这是必需的。

特性

• 运动追踪 --包含心率区域、训练负荷和预处理样本指标（速度分段、力量、高度、节奏、HRV）的训练
• 日常活动 --步数、卡路里、活动/非活动持续时间，包括每小时步数和活动区域细分
• 睡眠分析 --睡眠评分、阶段（浅/深/REM）、睡眠结构和睡眠期间的心率趋势
• 持续心率 --带有预处理半小时桶的24/7心率数据（平均值/分钟/最大值）
• 每晚充电 --ANS电荷、HRV趋势和呼吸频率分析
• 心脏负荷 --日应变、公差和载荷比指标
• SleepWise警觉性 --基于睡眠质量的小时警觉性预测
• 练习下载 --以FIT、TCX或GPX格式导出训练
• 双输出 --所有工具支持 markdown （人类可读）或 json （结构化）响应格式

为什么预处理很重要

Polar AccessLink API返回原始传感器数据-数千个单独的心率读数、具有数万个值的通信分离样本串以及每分钟的睡眠描记图条目。将其直接传递给人工智能助手将占用单个工具调用的大部分上下文窗口，几乎没有对话或多工具工作流的空间。

该服务器在原始数据到达AI之前将其预处理为紧凑、有意义的摘要：

结果是，一整天的活动、睡眠和心率数据可以轻松地存储在几百个令牌中，而不是数万个令牌中——这使得多日查询和跨域分析在一次对话中变得实用。

工具

该服务器在5个域中提供13个工具。

OAuth

用户管理

练习

日常活动

健康与康复

数据保留

Polar AccessLink API仅提供对最新数据的访问：

为了保存历史数据，请定期使用导出 polar_download_exercise 或 json 响应格式。

故障排除

“拒绝访问”错误

你需要注册你的用户。让克劳德打电话 polar_register_user 配置您的访问令牌后。

授权码无效或过期

授权码是一次性的，很快就会过期。生成新的授权URL并再次完成流程。

401未经授权的错误

验证您的 client_id 和 client_secret 正确的在 管理员.polarraccesslink.com.

未返回数据

• 确保您的Polar设备已与Polar Flow同步
• API仅返回最近的数据（请参阅 数据保留)

Manual OAuth Setup

如果你不想使用Claude的OAuth辅助工具：

1. 在以下位置创建应用程序 管理员.polarraccesslink.com
2. 设置重定向类型（例如。， https://localhost:8080/callback)
3. 指导用户授权：

   https://flow.polar.com/oauth2/authorization?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&scope=accesslink.read_all

1. 复制 code 重定向URL中的参数
2. 将代码替换为令牌：

   curl -X POST https://polarremote.com/v2/oauth2/token \
     -u "CLIENT_ID:CLIENT_SECRET" \
     -d "grant_type=authorization_code&code=AUTH_CODE&redirect_uri=YOUR_REDIRECT_URI"

1. 使用 access_token 作为 POLAR_ACCESS_TOKEN 和 x_user_id 作为 POLAR_USER_ID
2. 注册您的用户：

   curl -X POST https://www.polaraccesslink.com/v3/users \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"member-id": "YOUR_USER_ID"}'

许可证

麻省理工学院