personal-health-mcp
タニタ ヘルスプラネット API から体組成データ（体重・体脂肪率）を取得し、MCP ツールとして Claude Desktop 等の AI エージェントに提供します。
セットアップ
1. インストール
pip install -e .2. .env を作成
cp .env.example .env.env を編集して HEALTH_PLANET_CLIENT_ID・HEALTH_PLANET_CLIENT_SECRET・HEALTH_PLANET_REDIRECT_URI を設定してください。
3. 初回認証
python -m health_mcp.tanita.auth表示された URL をブラウザで開き、「アクセスを許可する」をクリック後、リダイレクト URL を貼り付けると .env にトークンが保存されます。
4. Claude Desktop に MCP サーバーを登録
claude_desktop_config.json に以下を追加してください。command には venv 内の Python 実行ファイルのフルパスを指定します。
Windows:
{
"mcpServers": {
"personal-health": {
"command": "C:/Users/<username>/path/to/personal-health-mcp/venv/Scripts/python.exe",
"args": ["-m", "health_mcp.server"]
}
}
}macOS / Linux:
{
"mcpServers": {
"personal-health": {
"command": "/path/to/personal-health-mcp/venv/bin/python",
"args": ["-m", "health_mcp.server"]
}
}
}
cwdの指定は不要です。サーバーは__file__を基点にプロジェクトルートを自動解決します。
MCP ツール一覧
| ツール | 説明 | |---|---| | get_latest_body_composition | 最新の体重・体脂肪率を取得（直近30日対象） | | get_body_composition | 指定期間（最大92日）の体組成データを取得 | | get_measurements_range | キャッシュ内データの日付範囲と件数を確認 | | get_profile | 生年月日・身長・性別を取得 | | list_available_metrics | 取得可能なメトリクス一覧を表示 |
プロフィールの再取得
タニタアプリでプロフィール情報を変更した場合：
python -m health_mcp.tanita.auth --reset-profile開発
pip install -e ".[dev]"
pytest # テスト
mypy src # 型チェック
ruff check src # リント
