Personal Health Tracker MCP服务器使用说明
项目简介
Personal Health Tracker 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在帮助用户跟踪和管理个人健康数据。它提供了一套工具和资源,用于记录锻炼、饮食和日常日记,并通过集成的 Prompt 模板支持 AI 辅助分析,例如使用 Claude 进行分析。
主要功能点
- 锻炼跟踪: 记录锻炼项目、组数、次数和力竭程度,支持康复训练的重量计算和历史分析。
- 营养管理: 记录膳食和食物,跟踪蛋白质和卡路里摄入,监控每日营养目标达成情况。
- 日记系统: 创建每日日记条目,跟踪情绪、精力、睡眠质量和压力水平,支持标签组织和趋势分析。
- AI 辅助分析: 提供 Prompt 模板,例如分析锻炼负荷、营养建议和日记洞察。
安装步骤
-
环境准备:
- 确保已安装 Python 3.10 或更高版本。
- 推荐使用 'pip' 或 'uv' 包管理器。
-
安装 Personal Health Tracker:
- 打开终端,执行以下命令安装:
或者使用 'uv':pip install -e .uv pip install -e .
- 打开终端,执行以下命令安装:
服务器配置
MCP 客户端需要配置以下 JSON 信息以连接到 Personal Health Tracker 服务器。以下是示例配置,请根据实际情况调整 'serverName' 和 'args' 中的参数。
{ "serverName": "Personal Health Tracker", "command": "personal-mcp", "args": ["run", "--name", "Personal Health Tracker"], "env": {} }
- 'serverName': MCP 服务器的名称,可以自定义,例如 "Personal Health Tracker"。
- 'command': 启动 MCP 服务器的命令,固定为 'personal-mcp'。
- 'args': 传递给 'personal-mcp' 命令的参数列表。
- 'run': 子命令,表示运行服务器。
- '--name "Personal Health Tracker"': 可选参数,设置服务器实例的名称,这里设置为 "Personal Health Tracker"。 可以根据需要修改,或者省略 '--name' 参数使用默认名称 "Personal Assistant"。
- 'env': 环境变量,默认为空 '{}'。
基本使用方法
-
启动服务器:
- 在终端中,导航到项目根目录(包含 'personal-mcp' 可执行文件的目录)。
- 运行以下命令启动服务器:
personal-mcp run - 您可以使用 '--name' 和 '--db-path' 等选项进行自定义配置,例如:
更多选项请使用 'personal-mcp --help' 查看。personal-mcp run --name "My Health Server" --db-path "./my_health_data.db"
-
连接 MCP 客户端:
- 在 MCP 客户端(例如 Claude Desktop 或 Smithery 等支持 MCP 协议的客户端)中,配置上述 服务器配置 JSON 信息,添加 Personal Health Tracker 服务器。
-
使用工具和资源:
- 客户端成功连接服务器后,即可调用服务器提供的 Tools (工具) 和 Resources (资源) 来记录和查询健康数据。 具体工具和资源的使用方法请参考仓库 README.md 中的 "MCP Tools" 和 "MCP Resources" 部分示例。
- 您还可以利用服务器提供的 Prompt 模板,结合 LLM 进行健康数据分析和获取建议。
信息
分类
生产力应用