Function Health MCP

功能健康MCP

MCP服务器和CLI 功能健康 实验室结果。查询生物标志物，跟踪就诊之间的变化，并获得健康建议——所有这些都可以从Claude Code或命令行获得。

特性

• 13个MCP工具 用于查询实验室结果、生物标志物深度挖掘、变化检测等
• 命令行界面 具有用于终端使用的匹配命令
• 先离线 -查询工具从本地存储读取，只有同步/检查命中API
• 测试轮模型 --按申购ID自动将多次访问实验室结果分组到完整的测试轮次中
• 变化检测 --比较测试轮次，看看哪些方面有所改善、恶化或发生了显著变化
• 生物标志物历史 --在所有测试轮次中跟踪任何生物标志物
• 安全 --仅以所有者权限存储的凭据（0o600个文件，0o700个目录）

快速开始

选项A：作为Claude代码插件安装

从插件市场安装零配置MCP设置，包括以下技能：

/plugin marketplace add daveremy/function-health-mcp
/plugin install function-health-mcp@function-health-mcp-plugins

这将自动配置MCP服务器并安装 /fh-lab-results 技能。

选项B：手动MCP设置

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "function-health": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "function-health-mcp"]
    }
  }
}

可选择复制引导斜线命令和背景上下文的技能：

mkdir -p .claude/skills
cp -r node_modules/function-health-mcp/skills/fh-lab-results .claude/skills/
cp -r node_modules/function-health-mcp/skills/fh-usage .claude/skills/

验证

首先，通过CLI进行身份验证（密码输入隐藏）：

npx -y -p function-health-mcp function-health login

自动重新身份验证

Firebase令牌在1小时后过期，通常会自动刷新。如果刷新令牌被撤销（例如，在长时间不活动后），您可以提供免提重新身份验证的凭据：

# Option 1: Environment variables (e.g., in .envrc with direnv)
export FH_EMAIL="your@email.com"
export FH_PASSWORD="your-password"

# Option 2: .env file (works without direnv — ideal for MCP plugins)
# Add to ~/lifeos/.env or ~/.env:
FH_EMAIL=your@email.com
FH_PASSWORD=your-password

MCP服务器检查 process.env 首先，然后回落到 .env 文件夹。这意味着即使通过以下方式启动，它也能正常工作 npx （例如，作为Claude Code插件），其中direnv未处于活动状态。

然后问克劳德你的实验室结果：

“显示我的实验室结果” “深入了解我的维生素D水平” “我最近两次访问之间发生了什么变化？”

Claude将同步您的数据，并以对话方式显示您的结果。

替代方案：从源代码安装

git clone https://github.com/daveremy/function-health-mcp.git
cd function-health-mcp
npm install && npm run build

然后直接使用CLI：

./dist/cli.js login
./dist/cli.js sync
./dist/cli.js summary

MCP工具

CLI命令

function-health login                  Authenticate with Function Health
function-health status                 Show auth status and data stats
function-health sync [--force]         Pull latest data
function-health check                  Quick check for new results
function-health results [options]      Query lab results
function-health biomarker        Deep dive on a biomarker
function-health summary                Health summary
function-health categories             List categories
function-health changes [--from] [--to]  Compare test rounds
function-health export [--markdown]    Full JSON export

定期监测 /loop

使用克劳德代码 /loop 自动检查新结果的命令：

/loop 6h /fh-lab-results check

每6小时检查一次。当检测到新结果时，它会同步并总结更改的内容。

数据存储

所有数据都存储在本地 ~/.function-health/:

~/.function-health/
  credentials.json     Auth tokens (0o600)
  latest.json          Pointer to most recent export
  sync-log.json        Sync history
  exports/
    2026-01-20/        One directory per test round (keyed by earliest visit date)
      results.json     All results across all visits in this round
      round-meta.json  Round metadata (requisitionId, visitDates, resultCount)
      biomarkers.json
      categories.json
      ...

测试轮模型

Function Health运行全面的实验室小组，需要在几周内进行1-3次实验室访问。一轮测试中的所有访问都是相同的 requisitionId.结果按轮次分组，以便 fh_summary 显示所有100+标记和 fh_changes 比较完整的轮次，而不是个人访问。

建筑

• 先离线：查询工具(results, biomarker, summary, categories, changes, recommendations, report)从本地JSON文件读取。仅 sync 和 check 进行API调用。
• 频率限制：API请求以250ms的间隔序列化，以尊重Function Health的API。
• 原子写入：导出使用临时目录，然后重命名模式以防止数据损坏。
• 优雅降级：可选的API终点（建议、注释、生物年龄）如果失败，则不会阻止导出。

从v0.5.0迁移

在v0.5.1中，技能从 .claude/skills/lab-results/ 到 skills/fh-lab-results/ 以及一个新的 skills/fh-usage/ 增加了参考技能。如果您的项目中复制了技能，请从新路径重新复制它们（请参见 手动MCP设置 上文）。

从v0.3.x迁移

在v0.4.0中，导出按测试轮次（requestId）分组，而不是按单个访问日期分组。在第一次同步时，旧的每次访问导出会自动迁移——共享一个requestId的多个访问目录会合并到一个轮目录中。无需手动操作。

从v0.2.x迁移

在v0.3.0中，所有MCP工具名称都从 function_health_* 到 fh_* 该技能被重新命名为 lab-results 到 fh-lab-results.

API 文档

该项目使用了一个反向工程的、未记录的API。看 docs/api-reference.md 用于完整的端点文档、数据模型、身份验证流程和已知的怪癖。

需求

• Node.js 18+（使用原生 fetch)
• A. 功能健康 用实验室结果说明

致谢

灵感来自 功能健康出口商 由Inigo Beitia Arevalo开发，该公司开创了导出功能健康实验室数据的逆向工程API方法。

许可证

麻省理工学院——见 许可证