个人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 文件。