JinDaGe - Personal Health Tracker MCP Details

article

README

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

Personal Health Tracker