Sport Health MCP

ローカルファーストのHuawei Health解析MCP Server。ユーザーは一度だけ HUAWEI_HEALTH_* 個人データ書き出しパッケージを提供すればよく、Agentは運動パフォーマンス、 運動中の生理指標、運動前後の健康コンテキストを読み取り、必要に応じて履歴の天気と 大気質を補完できます。

本プロジェクトは運動の振り返りを目的としており、医療診断や治療のアドバイスを提供するものではありません。

現在の機能

• Huawei個人データ書き出しディレクトリとコアJSONファイルを識別します。

• Huawei非標準JSON数値キーをフォールトトレラントに解析します。

• 運動サマリー、GPSトラック、心拍数、歩頻、速度、標高、トレーニング負荷を解析します。

• 運動前日、当日、翌日の心拍数、安静時心拍数、HRV、ストレス、血中酸素、睡眠段階を集計します。

• Open-Meteo履歴天気・大気質APIを呼び出し、レスポンスをローカルにキャッシュします。

• MCP経由でページングデータツールとレポート証拠パックを提供します。

Related MCP server: Apple Health MCP

インストール

Python 3.11以降を推奨し、プロジェクトディレクトリに仮想環境を作成します：

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"

Huawei書き出しパッケージはパッケージ化もコミットもされません。.gitignore はデフォルトで すべての HUAWEI_HEALTH_* ディレクトリを無視します。

ローカル確認

プロジェクトディレクトリに HUAWEI_HEALTH_* フォルダが1つだけある場合、自動的に識別されます：

sport-health-inspect inspect
sport-health-inspect list

明示的に指定することもできます：

sport-health-inspect --export-dir "D:\HealthData\HUAWEI_HEALTH_xxx" list

MCP Serverの起動

ローカルAgentには stdio を推奨します：

$env:SPORT_HEALTH_EXPORT_DIR="D:\HealthData\HUAWEI_HEALTH_xxx"
sport-health-mcp

MCPクライアント設定の基本形式は次のとおりです。実際のフィールド名はクライアントに依存します：

{
  "mcpServers": {
    "sport-health": {
      "command": "C:\\sport-health-mcp\\.venv\\Scripts\\sport-health-mcp.exe",
      "env": {
        "SPORT_HEALTH_EXPORT_DIR": "D:\\HealthData\\HUAWEI_HEALTH_xxx"
      }
    }
  }
}

MCPクライアントへの登録

MCP stdio をサポートするクライアントに前述の command と env 設定を追加し、保存後にクライアントを再起動します。 クライアントごとに設定ファイルの場所や外側のフィールド名が異なる場合があります。対応するクライアントのドキュメントに従ってください。

異なるAgentでの使用

• 同じPC：MCP stdio をサポートする各Agentは同じServerを起動できますが、そのAgentの 設定形式に従って一度登録する必要があります。

• 他のユーザーのPC：本プロジェクトをインストールし、自分の HUAWEI_HEALTH_* データパッケージを書き出し、 設定内のコマンドとデータディレクトリを自分の絶対パスに置き換えます。

• ウェブ版またはクラウドAgent：ユーザーのPC上にあるローカル stdio プロセスにはアクセスできません。このようなクライアントを サポートするには、認証付きのStreamable HTTPデプロイを別途提供し、暗号化アップロード、ユーザー分離、 データ削除、プライバシーコンプライアンスの仕組みを設計する必要があります。

プロジェクトは作者のHuaweiデータパッケージを共有しません。MCP Serverは汎用プログラムであり、 各ユーザーのデータは引き続きそのユーザーのローカルに保存されます。

MCPツール

• inspect_huawei_export: データパッケージの整合性をチェックします。

• list_activities: 運動を一覧表示します。

• get_activity_summary: 1回の運動サマリーを照会します。

• get_activity_track: GPS軌跡をぺーしてお問い合わせます。

• get_activity_samples: 心拍数、歩数、速度、高度のサンプルをページングで照会します。

• get_health_context: 運動前後の複数日の健康コンテキストを照会します。

• get_activity_environment: 履歴環境データを取得してキャッシュします。

• get_report_evidence_pack: Agentがレポートを作成するための決定的な証拠パックを生成します。

• get_report_contract: 固定のレポート章構成、ページトーク数を取得します。

Agentはまず list_activities を呼び出し、activity_id を選択した後、優先的に get_report_evidence_pack を呼び出し、返された report_contract に厳密に従ってレポートを出力することを推奨します。固定フォーマットは コア判断、パフォーマンス分析、体の反応、トレーニング提案のみを保持し、デバイスアプリがすでに表示している完全な指標の繰り返しは避けます。 元のカーブやトラジェクトを表示する必要がある場合にのみ、ページングされた詳細ツールを呼び出します。

テスト

テストフレームワークをインストールしなくても、標準ライブラリでテストを実行できます：

$env:PYTHONPATH="src"
python -m unittest discover -s tests -v

テストはコードで生成された合成運動記録のみを使用し、個人の書き出しデータには依存せず、含みません。

プライバシー境界

• 元の健康データはデフォルトでローカルでのみ読み取りされます。

• 環境補強ツールのみがネットワークにアクセスし、ルート中心点合わせて日付と時間範囲のみを送信します。

• MCPツールは読み取り専用で、Huawei書き出し情報ファイルを修正しません。

• ログや問題レポートを外部共有する前に、座標・時刻・デバイス識別子・健康指標を削除する必要があります。

• ソースコードを公開する前に、作業ディレクトリ全体を直接彼は圧縮しないでください。版本控制のように导出するか、 ビルド成果物を公開し、無視されている個人データディレクトリを一緒にパッケージングしないようにします。

ライセンス

本プロジェクトは MITライセンス を採用しています。セキュリティ問題を提出する前に SECURITY.md をお読みください。公開のIssueに本物の健康データ、GPSトラック、 環境キャッシュ、またはローカルパスを含むログをアップロードしないでください。

第三方服务信息サービスの商标

• 環境データは Open-Meteo より提供され、データには CC BY 4.0 が適用されます。表示時には情報源とライセンスを明記する必要があります。

• Open-Meteoの無料APIは非商用利用に限られ、呼び出し頻度の契約を受けます。商用利用の場合は商用インターフェースを利用するか、 公式ライセンスに従って自社で配備してください。詳細は Open-Meteo Terms を参照してください。

• 本プロジェクトは独立した社区コミュニティです。当時、华为の華為との間には所属・同意・承認関係はありません。 関連する製品名と商標は各権利者に帰属します。