個人用MCPサーバー

鍛冶屋のバッジ

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

特徴

ワークアウトの追跡

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

栄養管理

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

ジャーナルシステム

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

Related MCP server: MCP Personal Assistant Agent

インストール

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