个人MCP服务器

这是一个用于个人健康和福祉跟踪的模型上下文协议（Model Context Protocol, MCP）服务器。该服务器提供了工具和资源，用于跟踪锻炼、营养和日常日志条目，并通过Claude集成提供AI辅助分析。

功能

锻炼跟踪

• 记录练习、组数和次数
• 跟踪感知努力程度和锻炼后的感受
• 考虑康复因素计算安全训练重量
• 历史锻炼分析
• 肩部康复支持
• 基于RPE（主观疲劳度评分）的负荷管理

营养管理

• 记录餐食和个人食物项目
• 跟踪蛋白质和卡路里摄入量
• 监测饥饿感和满足感水平
• 每日营养目标及进度
• 锻炼前后营养跟踪
• 餐时分析

日记系统

• 每日条目，包括心情和能量跟踪
• 睡眠质量和压力水平监测
• 基于标签的组织
• 趋势分析和洞察
• 锻炼、营养与福祉之间的相关性分析
• 心情和能量水平模式识别

安装

通过Smithery安装

要通过Smithery自动为Claude Desktop安装个人健康追踪器：

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

先决条件

• Python 3.10或更高版本
• pip 或 uv 包管理器

使用pip

bash pip install -e .

开发环境安装

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

使用

基本服务器

使用默认设置运行服务器： bash personal-mcp run

开发模式

开发时启用热重载运行： bash personal-mcp dev

MCP检查器

使用MCP检查器进行调试： bash personal-mcp inspect

Claude Desktop集成

安装到Claude Desktop： bash personal-mcp install --claude-desktop

配置选项

bash personal-mcp --help

可用选项：

• --name: 设置服务器名称 (默认: "Personal Assistant")
• --db-path: 指定数据库位置
• --dev: 启用开发模式
• --inspect: 使用MCP Inspector运行
• -v, --verbose: 启用详细日志记录

MCP工具

锻炼工具

python

记录一次锻炼

workout = { "date": "2024-01-07", "exercises": [ { "name": "卧推", "sets": [ {"weight": 135, "reps": 10, "rpe": 7} ] } ], "perceived_effort": 8 }

计算训练重量

params = { "exercise": "卧推", "base_weight": 200, "days_since_surgery": 90, "recent_pain_level": 2, "recent_rpe": 7 }

营养工具

python

记录一餐

meal = { "meal_type": "午餐", "foods": [ { "name": "鸡胸肉", "amount": 200, "unit": "g", "protein": 46, "calories": 330 } ], "hunger_level": 7, "satisfaction_level": 8 }

检查营养目标

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

日记工具

python

创建日记条目

entry = { "entry_type": "daily", "content": "今天锻炼很棒...", "mood": 8, "energy": 7, "sleep_quality": 8, "stress_level": 3, "tags": ["锻炼", "恢复"] }

分析条目

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

开发

运行测试

bash

运行所有测试

pytest

带覆盖率运行

pytest --cov=personal_mcp

运行特定测试文件

pytest tests/test_database.py

代码质量

bash

格式化代码

black src/personal_mcp

代码检查

ruff check src/personal_mcp

类型检查

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## 贡献

1. Fork 仓库
2. 创建一个功能分支
3. 提交你的更改
4. 推送到该分支
5. 创建一个 Pull Request

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。