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 許可證。