個人用MCPサーバー

個人の健康とウェルビーイングを追跡するためのモデルコンテキストプロトコルサーバー。このサーバーは、Claude統合によるAI支援分析に加え、ワークアウト、栄養、日々の日記を追跡するためのツールとリソースを提供します。

特徴

ワークアウトの追跡

エクササイズ、セット、反復回数を記録する
運動後の感覚や努力の認識を追跡する
リハビリテーションを考慮した安全なトレーニング重量を計算する
過去のトレーニング分析
肩のリハビリテーションサポート
RPEベースの負荷管理

栄養管理

食事と個々の食品を記録する
タンパク質とカロリーの摂取量を追跡する
空腹感と満足度を監視する
毎日の栄養目標と進捗
運動前後の栄養追跡
食事タイミング分析

ジャーナルシステム

気分とエネルギーを追跡する毎日のエントリ
睡眠の質とストレスレベルのモニタリング
タグベースの組織
トレンド分析と洞察
トレーニング、栄養、健康状態の相関分析
気分とエネルギーレベルのパターン認識

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Personal Health Tracker を自動的にインストールするには:

npx -y @smithery/cli install personal-mcp --client claude

前提条件

Python 3.10以上
pip または uv パッケージマネージャー

pipの使用

pip install -e .

開発インストール

git clone https://github.com/yourusername/personal-mcp.git
cd personal-mcp
uv pip install -e ".[dev]"

使用法

ベーシックサーバー

デフォルト設定でサーバーを実行します。

personal-mcp run

開発モード

開発用にホットリロードで実行します。

personal-mcp dev

MCP検査官

MCP インスペクターでデバッグします。

personal-mcp inspect

クロードデスクトップ統合

Claude Desktop にインストール:

personal-mcp install --claude-desktop

設定オプション

personal-mcp --help

利用可能なオプション:

--name : サーバー名を設定します (デフォルト: "Personal Assistant")
--db-path : データベースの場所を指定する
--dev : 開発モードを有効にする
--inspect : MCP Inspector で実行
-v, --verbose : 詳細ログを有効にする

MCPツール

トレーニングツール

# Log a workout
workout = {
    "date": "2024-01-07",
    "exercises": [
        {
            "name": "Bench Press",
            "sets": [
                {"weight": 135, "reps": 10, "rpe": 7}
            ]
        }
    ],
    "perceived_effort": 8
}

# Calculate training weights
params = {
    "exercise": "Bench Press",
    "base_weight": 200,
    "days_since_surgery": 90,
    "recent_pain_level": 2,
    "recent_rpe": 7
}

栄養ツール

# Log a meal
meal = {
    "meal_type": "lunch",
    "foods": [
        {
            "name": "Chicken Breast",
            "amount": 200,
            "unit": "g",
            "protein": 46,
            "calories": 330
        }
    ],
    "hunger_level": 7,
    "satisfaction_level": 8
}

# Check nutrition targets
targets = await mcp.call_tool("check_nutrition_targets", {"date": "2024-01-07"})

ジャーナルツール

# Create a journal entry
entry = {
    "entry_type": "daily",
    "content": "Great workout today...",
    "mood": 8,
    "energy": 7,
    "sleep_quality": 8,
    "stress_level": 3,
    "tags": ["workout", "recovery"]
}

# Analyze entries
analysis = await mcp.call_tool("analyze_journal_entries", {
    "start_date": "2024-01-01",
    "end_date": "2024-01-07"
})

発達

テストの実行

# Run all tests
pytest

# Run with coverage
pytest --cov=personal_mcp

# Run specific test file
pytest tests/test_database.py

コード品質

# Format code
black src/personal_mcp

# Lint code
ruff check src/personal_mcp

# Type checking
mypy src/personal_mcp

プロジェクト構造

personal-mcp/
├── src/
│   └── personal_mcp/
│       ├── tools/
│       │   ├── workout.py
│       │   ├── nutrition.py
│       │   └── journal.py
│       ├── database.py
│       ├── models.py
│       ├── resources.py
│       ├── prompts.py
│       └── server.py
├── tests/
│   ├── test_database.py
│   ├── test_server.py
│   └── test_cli.py
├── pyproject.toml
└── mcp.json

貢献

リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

Personal MCP Server