inbody-api-mcp

inbody-api-mcp

面向 Claude.ai、ChatGPT 和 Grok 的托管版本即将推出。 加入候补名单 →

这是一个用于 InBody 身体成分数据的 MCP（Model Context Protocol） 服务，基于对 InBody Android 应用所用移动 REST API 的逆向工程构建。

InBody 没有公开 API，也没有用于查看个人扫描数据的网页界面。此服务会访问移动应用所用的相同 JSON REST 端点，将您的身体成分历史记录（体脂、肌肉量、体水分、分段阻抗）提供给任何 MCP 客户端。

功能

• 个人资料 -- 身份信息和基准指标（身高、体重、年龄、性别）
• 扫描历史记录 -- 按时间顺序排列的摘要（体重、BMI、体脂百分比、肌肉量）
• 完整扫描指标 -- 完整身体成分（BCA）、包含正常范围的 BMI/体脂百分比/肌肉（MFA），以及分段/多频阻抗（IMP）
• 自动区域路由 -- 根据您的国家/地区代码解析正确的区域 API 主机
• 自动重新认证 -- 缓存 24 小时有效的 JWT，并在过期时重新登录

快速开始

1. 安装 uv

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 设置凭据

export INBODY_LOGIN_ID="3026323617"   # registration phone number, digits only
export INBODY_LOGIN_PW="your-password"
export INBODY_COUNTRY_CODE="US"       # ISO country code (default US)

INBODY_LOGIN_ID 是注册时使用的电话号码，而不是电子邮箱 -- 仅填写数字，不含国家/地区代码或 +（例如：3026323617）。InBody 使用电话号码进行登录；电子邮箱仅作为个人资料数据返回。使用电子邮箱会导致登录失败并返回 EmptyData。

3. 配置 MCP 客户端

uvx 会按需下载并运行服务，无需单独安装。

OpenCode（opencode.json）

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "inbody": {
      "type": "local",
      "command": ["uvx", "inbody-api-mcp"],
      "environment": {
        "INBODY_LOGIN_ID": "{env:INBODY_LOGIN_ID}",
        "INBODY_LOGIN_PW": "{env:INBODY_LOGIN_PW}",
        "INBODY_COUNTRY_CODE": "US"
      },
      "enabled": true
    }
  }
}

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "inbody": {
      "command": "uvx",
      "args": ["inbody-api-mcp"],
      "env": {
        "INBODY_LOGIN_ID": "3026323617",
        "INBODY_LOGIN_PW": "your-password",
        "INBODY_COUNTRY_CODE": "US"
      }
    }
  }
}

可用工具

工具	描述
get_profile	用户身份信息和基准指标（身高、体重、年龄、性别）
get_scan_count	账户中的扫描总数
list_scans	按时间顺序排列的扫描摘要（体重、BMI、体脂百分比、肌肉量）
get_scan	单次扫描的完整指标集（BCA / MFA / IMP 块）

此服务为只读服务：不提供写入或删除端点。

工作原理

此服务与区域 *.lookinbody.com REST API 通信，该 API 与 InBody Android 应用（v2.8.31）使用的是同一后端。该 API 是通过 mitmproxy 捕获应用流量并根据实时 API 验证载荷结构进行逆向工程得到的。

认证流程：

1. POST /CommonAPI/GetCountryInfoV2（在 appapicommon.lookinbody.com 上）会返回按国家/地区划分的主机表。与您的 ISO 国家/地区代码对应的 Type == "API" 行会提供区域 API 基础地址（美国 -> appapiusav2.lookinbody.com）以及请求正文中使用的数字电话代码。
2. POST /V2/Main/GetLoginWithSyncDataPartV2 会将登录 ID 和密码交换为有效期为 24 小时的 JWT、刷新令牌和账户 UID。
3. 后续调用会发送 Authorization: Bearer <JWT>。令牌过期时，客户端会自动重新认证。

每条扫描记录包含三个嵌套块：BCA（身体成分分析——体水分、蛋白质、矿物质、脂肪、分段水分）、MFA（BMI、体脂百分比、骨骼肌量、腰臀比及其正常范围）和 IMP（按频率和身体部位划分的原始阻抗）。

Python API

您可以直接使用客户端：

from inbody_api_mcp.client import InBodyClient

client = InBodyClient()

# Total number of scans
count = client.get_scan_count()

# Recent scans (newest first), paginated
scans = client.get_scans(number=20, index=0)

# User profile
profile = client.get_user_info()

传输方式

仅支持 stdio。MCP 客户端（OpenCode、Claude Desktop）通过 uvx/uv 直接启动 stdio 进程。

许可证

MIT