macrofactor-mcp

回復できていますか？ 補給はうまくいきましたか？ 来週は何を変えるべきですか？ MacroFactor の栄養データと Garmin のトレーニングデータを組み合わせた唯一の MCP です。

MacroFactor MCP は、ローカルで動作する補給と回復の意思決定エンジンです。MCP クライアントに MacroFactor のエクスポートデータを渡し、必要に応じて Garmin を追加して、栄養、睡眠、身体、トレーニングの画面を手作業で比較する代わりに、判断を求めることができます。

クイックスタート

uv をインストールし、パッケージ化されたサーバーが起動することを確認します。

uvx macrofactor-mcp

MacroFactor からデータをエクスポートし、.xlsx ファイルをローカルのディレクトリに置いて、これを MCP クライアントの設定に追加します。絶対パスを使用してください。

{
  "mcpServers": {
    "macrofactor": {
      "command": "uvx",
      "args": ["macrofactor-mcp"],
      "env": {
        "MACROFACTOR_DATA_DIR": "/absolute/path/to/macrofactor-exports",
        "MACROFACTOR_DB_PATH": "/absolute/path/to/macrofactor.duckdb"
      }
    }
  }
}

MCP クライアントを再起動します。サーバーは起動時に新しいワークブックをインポートします。 setup_check を実行してから、以下の質問のいずれかを尋ねてください。デスクトップクライアントで uvx が見つからない場合は、"uvx" を which uvx が返す絶対パスに置き換えてください。

4 つの主要ワークフロー

以下のすべての例では、合成データを使用しています。

recovery_check — 回復できていますか？

昨夜の睡眠、HRV、ボディバッテリー、トレーニング負荷、昨日の補給状況を組み合わせて、コンディションを表示します。

Recovery Check: 2026-07-08
Sleep: 7h 38m, score 82; HRV +4 vs 7-day average
Training load: ACWR 1.08 (optimal)
Yesterday: 96% calorie target; 101% protein target
Overall: All systems go — 4 positive signals.

daily_briefing — 今日のシグナルを総合すると、どのような状況ですか？

栄養とトレーニングのログを個別に見るのではなく、その日の状況を一目で確認できます。

Daily Briefing: 2026-07-08
Intake: 2,340 kcal (P 171g / F 72g / C 248g)
Adherence: 98% calories | 101% protein
Body Battery: 28 → 83 | Sleep: 7h 38m, score 82
Training: Productive | Load 612/568 (ACWR 1.08)

weekly_report — 来週は何を変えるべきですか？

7 日間の栄養、体重、ワークアウト、睡眠、トレーニング負荷を確認します。

Weekly Report: 2026-07-02 to 2026-07-08
Average: 2,315 kcal | 168g protein
On target: calories 6/7 days | protein 7/7 days
Training: 4 sessions | Sleep: 7h 26m average
Next-week signal: fueling was consistent; protect sleep before adding load.

nutrition_performance_correlation — 補給はうまくいきましたか？

栄養と翌日の Garmin の回復シグナルを比較します。サンプル数も報告するため、データセットが小さい場合や欠落している場合も把握できます。

Nutrition → Performance Correlation: 28 paired days
Protein >=90% target: next-day HRV 51 vs 45 (+6)
Protein >=90% target: sleep score 81 vs 76 (+5)
Energy deficit days: body battery 68 vs 75 (-7)
Observation: higher-protein days tended to precede better recovery.

MacroFactor のみ、または MacroFactor + Garmin

モード	利用可能な判断
MacroFactor のみ	栄養、体重、ワークアウト、daily_briefing、weekly_report。回復に関する出力では、利用可能な栄養シグナルを使用します。
MacroFactor + Garmin	睡眠、HRV、ボディバッテリー、アクティビティ、トレーニング負荷を含む、4 つすべての主要ワークフロー。

Garmin は任意です。有効にするには、GARMINTOKENS を既存のローカル Garth/Garmin トークンディレクトリに設定してから、sync_garmin を実行します。

プラットフォームのサポート

• macOS および Linux
• Windows は未テストです
• Python 3.10 以降

制限事項

• v0.1 では MacroFactor から手動でエクスポートする必要があります。MacroFactor API には接続しません。
• Garmin との相関ワークフローには、MacroFactor と Garmin で日付が重複している必要があります。
• 相関は観察に基づくものであり、ある行動が別の結果を引き起こした証明ではありません。
• インポートは、現行の MacroFactor Quick Export および All-Time Data のワークブック形式に対応しています。

プライバシー

栄養、身体、ワークアウト、Garmin の生データは、ローカルの DuckDB データベースに保存されます。サーバーがそのデータベースをアップロードすることはありません。ただし、MCP ツールの結果は、サーバーが接続しているモデルまたはクライアントに送信されます。そのクライアントのデータポリシーを確認し、共有したくない詳細を求めないようにしてください。

免責事項

これは非公式のプロジェクトです。MacroFactor または Stronger By Science とは提携しておらず、承認やサポートも受けていません。医療上の助言ではなく、資格を持つ医療専門家による診療に代わるものではありません。

MIT License の下で公開されています。

mcp-name: io.github.NasserAlbusaidi/macrofactor-mcp