金大哥 - renpho-mcp-server MCP 详情

article

README

🚀 Renpho MCP 服务器

Renpho MCP 服务器是一个模型上下文协议（MCP）服务器，可让你从 Renpho 智能秤获取身体成分数据。你可以直接通过 Claude、Cursor 或任何支持 MCP 的客户端查询体重、体脂、肌肉量和其他健康指标。

✨ 主要特性

身体成分数据：提供体重、BMI、体脂百分比、肌肉量、水分百分比、骨量、内脏脂肪、代谢年龄、基础代谢率等数据。
体重趋势：可在自定义的时间段（7 - 365 天）内跟踪体重变化。
健康分类：自动对 BMI、体脂和内脏脂肪进行类别评估。
测量历史：支持通过过滤选项查看历史数据。
安全可靠：凭证以环境变量形式存储，不会被记录。

📦 安装指南

git clone https://github.com/StartupBros/renpho-mcp-server.git
cd renpho-mcp-server
npm install
npm run build

📚 详细文档

配置

创建一个 .env 文件（或设置环境变量）：

RENPHO_EMAIL=your-email@example.com
RENPHO_PASSWORD=your-password

Claude 代码配置

添加到你的 MCP 设置中（~/.claude/settings.json 或项目的 .claude/settings.json）：

{
  "mcpServers": {
    "renpho": {
      "command": "node",
      "args": ["/path/to/renpho-mcp-server/dist/index.js"],
      "env": {
        "RENPHO_EMAIL": "your-email@example.com",
        "RENPHO_PASSWORD": "your-password"
      }
    }
  }
}

Claude 桌面端配置

添加到 claude_desktop_config.json 中：

{
  "mcpServers": {
    "renpho": {
      "command": "node",
      "args": ["/path/to/renpho-mcp-server/dist/index.js"],
      "env": {
        "RENPHO_EMAIL": "your-email@example.com",
        "RENPHO_PASSWORD": "your-password"
      }
    }
  }
}

可用工具

| 工具 | 描述 | |------|-------------| | get_latest_measurement | 获取最近的身体成分测量数据 | | get_body_composition | 获取带有健康分类的详细身体成分数据 | | get_weight_trend | 分析 N 天内的体重变化 | | get_measurements | 按日期过滤获取历史测量数据 | | get_current_user | 获取用户个人资料信息 | | health_check | 验证 API 连接状态 |

使用示例

配置完成后，你可以向 Claude 提问：

"我当前的体重和身体成分如何？"
"显示我过去 90 天的体重趋势"
"我今年的体脂百分比有什么变化？"
"获取我最近的 10 次测量数据"

技术细节

使用 Renpho Health API（cloud.renpho.com），而非旧版 API。
在 API 通信中实现了 AES - 128 - ECB 加密。
处理 JavaScript 中用于大用户 ID 的 BigInt 精度问题。
缓存认证令牌（50 分钟）和测量数据（5 分钟），以减少 API 调用。

隐私说明

凭证仅用于与 Renpho 的 API 进行身份验证。
不会永久存储数据，也不会将数据发送给第三方。
所有通信均使用 HTTPS。

鸣谢

API 逆向工程基于 forkerer 的 RenphoGarminSync - CLI。

📄 许可证

本项目采用 MIT 许可证。

renpho-mcp-server