Renpho MCP Server

🚀 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"
      }
    }
  }
}

可用工具

使用示例

配置完成后，你可以向 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 许可证。