🚀 个人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配置文件
🤝 贡献指南
- Fork仓库。
- 创建功能分支。
- 提交更改。
- 推送到分支。
- 创建Pull Request。
📄 许可证
本项目遵循MIT许可证，详情请查阅LICENSE文件。