Renpho MCP Server

🚀 Renpho MCP Server

このサーバーはModel Context Protocol (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暗号化を実装しています。
• 大きなユーザーIDに対してJavaScriptのBigInt精度を処理します。
• 認証トークン（50分）と測定値（5分）をキャッシュしてAPI呼び出しを減らします。

🛡️ プライバシー

• 資格情報はRenphoのAPIとの認証にのみ使用されます。
• データは永続的に保存されたり、第三者に送信されたりすることはありません。
• すべての通信にHTTPSを使用しています。

📝 クレジット

APIのリバースエンジニアリングは、forkererによる RenphoGarminSync-CLI をベースに行われています。

📄 ライセンス

MIT