Personal Health Tracker

🚀 個人MCP服務器

個人MCP服務器是一個用於個人健康與福祉追蹤的模型上下文協議（Model Context Protocol）服務器。它提供了一系列工具和資源，可用於記錄鍛鍊、營養和日常日記條目，並藉助Claude集成實現AI輔助分析，助力個人更好地管理健康。

🚀 快速開始

個人MCP服務器為用戶提供了便捷的個人健康與福祉追蹤功能。你可以通過以下步驟快速開啟使用之旅。

✨ 主要特性

鍛鍊追蹤

• 可詳細記錄練習項目、組數和次數。
• 能跟蹤感知努力程度和鍛鍊後的感受。
• 依據康復考慮因素計算安全訓練重量。
• 支持歷史鍛鍊分析，助你瞭解自身鍛鍊情況。
• 提供肩部康復支持。
• 基於感知負荷進行負載管理。

營養管理

• 能夠記錄餐次和單項食品。
• 可追蹤蛋白質和熱量攝入。
• 監控飢餓感和滿足度水平。
• 跟蹤每日營養目標及進展。
• 可記錄瑜伽前後的營養攝入情況。
• 支持餐後間隔分析。

日記系統

• 支持每日記事，同時包含心情和能量追蹤。
• 可監控睡眠質量與壓力水平。
• 採用標籤組織管理，方便分類。
• 能進行趨勢分析並提供見解。
• 分析鍛鍊、營養與福祉之間的相關性。
• 識別心情與能量水平中的模式。

📦 安裝指南

通過Smithery安裝

若要自動通過Smithery安裝Personal Health Tracker for Claude Desktop，可使用以下命令：

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]"

💻 使用示例

基礎用法

以默認設置運行服務器：

server.py

高級用法

通過命令行進行交互式操作：

python cli.py

📚 詳細文檔

請查閱官方文檔獲取詳細信息。

🔧 技術細節

項目結構

personal-mcp/
├── src/
│   └── personal_mcp/
│       ├── tools/
│       │   ├── workout.py           # 鍛鍊相關工具
│       │   ├── nutrition.py         # 營養相關工具
│       │   └── journal.py           # 日記管理工具
│       ├── database.py              # 數據庫處理模塊
│       ├── models.py                 # 模型定義文件
│       ├── resources.py             # 資源管理模塊
│       ├── prompts.py               # 提示模板集合
│       └── server.py                # 服務器主程序
├── tests/
│   ├── test_workout.py              # 鍛鍊功能測試
│   ├── test_nutrition.py            # 營養功能測試
│   └── test_journal.py              # 日記功能測試
├── pyproject.toml                  # 項目依賴管理文件
└── mcp.json                        # MCP配置文件

🤝 貢獻指南

1. Fork倉庫。
2. 創建功能分支。
3. 提交更改。
4. 推送到分支。
5. 創建Pull Request。

📄 許可證

本項目遵循MIT許可證，詳情請查閱LICENSE文件。