Personal Health Tracker MCP服务器使用说明

项目简介

Personal Health Tracker 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在帮助用户跟踪和管理个人健康数据。它提供了一套工具和资源,用于记录锻炼、饮食和日常日记,并通过集成的 Prompt 模板支持 AI 辅助分析,例如使用 Claude 进行分析。

主要功能点

  • 锻炼跟踪: 记录锻炼项目、组数、次数和力竭程度,支持康复训练的重量计算和历史分析。
  • 营养管理: 记录膳食和食物,跟踪蛋白质和卡路里摄入,监控每日营养目标达成情况。
  • 日记系统: 创建每日日记条目,跟踪情绪、精力、睡眠质量和压力水平,支持标签组织和趋势分析。
  • AI 辅助分析: 提供 Prompt 模板,例如分析锻炼负荷、营养建议和日记洞察。

安装步骤

  1. 环境准备:

    • 确保已安装 Python 3.10 或更高版本。
    • 推荐使用 'pip' 或 'uv' 包管理器。
  2. 安装 Personal Health Tracker:

    • 打开终端,执行以下命令安装:
      pip install -e .
      或者使用 'uv':
      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': 环境变量,默认为空 '{}'。

基本使用方法

  1. 启动服务器:

    • 在终端中,导航到项目根目录(包含 'personal-mcp' 可执行文件的目录)。
    • 运行以下命令启动服务器:
      personal-mcp run
    • 您可以使用 '--name' 和 '--db-path' 等选项进行自定义配置,例如:
      personal-mcp run --name "My Health Server" --db-path "./my_health_data.db"
      更多选项请使用 'personal-mcp --help' 查看。
  2. 连接 MCP 客户端:

    • 在 MCP 客户端(例如 Claude Desktop 或 Smithery 等支持 MCP 协议的客户端)中,配置上述 服务器配置 JSON 信息,添加 Personal Health Tracker 服务器。
  3. 使用工具和资源:

    • 客户端成功连接服务器后,即可调用服务器提供的 Tools (工具) 和 Resources (资源) 来记录和查询健康数据。 具体工具和资源的使用方法请参考仓库 README.md 中的 "MCP Tools" 和 "MCP Resources" 部分示例。
    • 您还可以利用服务器提供的 Prompt 模板,结合 LLM 进行健康数据分析和获取建议。

信息

分类

生产力应用