oak-longevity-mcp-server

oak-longevity-mcp-server

一个面向长寿与代谢医学的 MCP 服务，提供药物目录、循证给药方案、禁忌筛查、药物相互作用检查、必要的基线实验室检查、持续监测计划、FDA/配制药监管状态，以及患者初诊路径建议，涵盖 35 种化合物。

由 Keith Schmidt 医学博士为 Oak Longevity Institute 构建。该机构是在伊利诺伊州提供远程医疗服务的长寿医学诊所。此服务让任何 MCP 客户端（Claude Desktop、Claude Code 或你自己的 Agent）都能使用诊所的临床参考数据，并采用适合免费/高级付费模式的结构。

⚠️ 用于临床决策支持，不构成医疗建议。 所有输出均须由持证临床医生审核。这里的许多长寿医学化合物都属于超适应症使用、配制药或研究药物/未获 FDA 批准的药物。 给药、禁忌、相互作用、实验室检查及监管数据会频繁变化，请务必根据最新的原始文献、FDA/DEA 资源及所在州的药学委员会信息进行核实。

---

功能

工具	层级	描述
get_medication_list	免费	完整药物目录，按类别分组，包含 ID、药物类别和 DEA/处方药管制级别。
get_medication_details	免费	单种药物的作用机制、剂型、适用/不适用人群及管制级别。
get_fda_status	免费	FDA 批准状态、DEA 管制级别、503A/503B 配制药相关注意事项、批准用途及超适应症说明。
get_dosing_protocol	高级付费	循证给药方案：按适应症提供给药途径、起始剂量、剂量递增、维持剂量、最大剂量、证据等级及实用建议。
get_required_labs	高级付费	处方前建议进行的基线实验室检查/评估，按检查项目分组并附理由。
get_monitoring_plan	高级付费	持续监测计划——检查项目、间隔及行动/阈值。
check_contraindications	高级付费	根据患者档案（年龄、性别、健康状况、用药）筛查药物 → 根据触发的检查结果给出 通过 / 警示 / 拒绝。
check_drug_interactions	高级付费	检查药物清单中的两两相互作用警示，按严重程度排序，并提供机制及处理方式。
screen_patient_intake	高级付费	将患者症状/目标映射为建议的治疗路径，并提供一线药物、辅助药物及检查建议。

八大类别：体重管理、肽类治疗、激素优化、长寿与代谢、性健康、免疫与炎症、毛发修复、皮肤科。

每个工具都接受药物的名称、ID 或品牌名/别名（例如，"Tirzepatide"、"tirzepatide"、"Mounjaro" 或 "copper peptide" → GHK-Cu）。无法识别的查询会返回“你是否想查”建议。

涵盖的化合物

Semaglutide · Tirzepatide · Liraglutide · Naltrexone/Bupropion · BPC-157 · Sermorelin · CJC-1295/Ipamorelin · Ipamorelin · Tesamorelin · Thymosin Beta-4 (TB-500) · Testosterone (cypionate & cream) · Estradiol · Progesterone · DHEA · Anastrozole · Pregnenolone · hCG · NAD+ · Metformin · Rapamycin · Berberine · Resveratrol · NMN · PT-141 · Oxytocin · Tadalafil · Sildenafil · Thymosin Alpha-1 · Glutathione · Low-Dose Naltrexone · Finasteride · Oral Minoxidil · GHK-Cu · Tretinoin。

---

安装与构建

git clone <repo> longevity-mcp-server
cd longevity-mcp-server
npm install

npm run build             # compile TypeScript → dist/ and copy data
npm run smoke             # end-to-end test (optional)

临床数据以 JSON 格式存放在 src/data/ 中，构建时会复制到 dist/data/。

---

在 Claude Desktop 中使用

添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "oak-longevity": {
      "command": "node",
      "args": ["/absolute/path/to/longevity-mcp-server/dist/index.js"],
      "env": { "LONGEVITY_LICENSE_KEY": "OAK-XXXX-XXXX-XXXX" }
    }
  }
}

重启 Claude Desktop。然后你可以询问如下问题：

• “列出肽类疗法选项。”
• “替尔泊肽用于减重的给药方案是什么？”
• “我可以给一位正在服用硝酸甘油的 60 岁男性开他达拉非吗？”
• “检查雷帕霉素、辛伐他汀和克拉霉素之间的相互作用。”
• “开始睾酮治疗前需要做哪些基线化验？”
• “一位患者反映疲劳、性欲低下，并希望减重——适合哪些治疗路径？”

有关 npx 版本，请参阅 examples/claude_desktop_config.json。

在 Claude Code 中使用

claude mcp add oak-longevity -- node /absolute/path/to/longevity-mcp-server/dist/index.js

在本地检查

npm run inspect          # opens the MCP Inspector against the stdio server

---

远程托管（HTTP / SSE）

相同的工具通过 Streamable HTTP 提供，可用于远程部署（MCPize、VPS 或无服务器环境）：

npm run build
PORT=3000 node dist/http.js
# → POST http://localhost:3000/mcp     (GET /health for a liveness check)

HTTP 传输是无状态且支持多租户的：每位客户的许可证密钥都从请求头中读取，因此单次部署即可为多位客户提供服务。

X-Oak-License: OAK-XXXX-XXXX-XXXX        (preferred)
Authorization: Bearer OAK-XXXX-XXXX-XXXX (also accepted)

---

变现与许可

该服务内置免费 / 高级分层机制，可通过最少改动接入计费服务商（Stripe、MCPize）。

• 免费层：get_medication_list、get_medication_details、get_fda_status——目录和监管参考信息。
• **高级层：**临床决策支持引擎——给药方案、基线化验、监测计划、禁忌筛查、药物相互作用检查和接诊路径建议。

高级工具仍可被发现（它们会出现在 tools/list 中，以便客户端展示升级选项），但在没有有效权限的情况下调用时，会返回升级提示，而非数据。

权限解析

通过环境变量（stdio）或请求头（HTTP）进行配置：

变量	用途
LONGEVITY_LICENSE_KEY	客户的许可证密钥。
LONGEVITY_TIER	强制设为 premium 或 free（可自托管 / 企业覆盖）。
LONGEVITY_VALID_KEYS	以逗号分隔的密钥允许列表，这些密钥将被视为有效的高级密钥（手动发放 / 测试）。
LONGEVITY_LICENSE_VERIFY_URL	可选的 HTTP 端点，用于远程验证密钥。设置后，密钥将通过此服务验证，而非在本地验证。

本地签发的密钥格式为 OAK-XXXX-XXXX-XXXX。用于生产环境时，将 LONGEVITY_LICENSE_VERIFY_URL 指向你的计费 Webhook；该端点应接受 { "key": "..." }，并返回 { "valid": true, "tier": "premium", "expiresAt": "..." }。

验证层完全位于 src/licensing.ts 中，并通过 LicenseProvider 接口实现——无需改动任何工具即可替换其实现。

---

项目结构

longevity-mcp-server/
├── src/
│   ├── index.ts          # stdio entry point (Claude Desktop / Code)
│   ├── http.ts           # Streamable HTTP entry point (remote hosting)
│   ├── server.ts         # builds the MCP server + tier gating
│   ├── licensing.ts      # free/premium entitlement (pluggable)
│   ├── data.ts           # data loading + medication resolver
│   ├── types.ts          # clinical data types
│   ├── tools/            # one file per MCP tool (9 tools)
│   └── data/             # clinical data (JSON)
│       ├── categories.json
│       ├── medications.json
│       ├── dosing.json
│       ├── contraindications.json
│       ├── interactions.json
│       ├── labs.json
│       ├── fda.json
│       └── pathways.json
├── scripts/
│   ├── copy-assets.mjs   # copy JSON into dist/ at build
│   └── smoke-test.mjs    # end-to-end MCP client/server test
├── examples/
│   └── claude_desktop_config.json
├── package.json
├── tsconfig.json
├── LICENSE
└── README.md

数据模型

临床数据由标准药理学参考资料和长寿医学实践（内分泌学会 / 更年期学会 / ISSWSH 指南、FDA 标签和短缺 / 散装物质清单，以及针对超说明书和研究性化合物的同行评审文献）人工整理而成。每个数据集都以药物 id 为键：

• medications.json — 类别、作用机制、剂型、候选人特征、用药计划。
• dosing.json — 按适应症列出的给药途径 / 起始剂量 / 递增方案 / 维持剂量 / 最大剂量 / 证据等级。
• contraindications.json — 黑框警告、绝对和相对禁忌症（含可通过机器匹配的病症关键词）、注意事项、妊娠相关信息。
• interactions.json — 按药物列出的相互作用规则（严重程度、影响、处理方式）。
• labs.json — 基线检查项目和持续监测计划。
• fda.json — 批准状态、管制分类、503A/503B 配制注意事项、获批用途、参考资料。
• pathways.json — 15 条接诊路径，将症状 / 目标映射到一线用药及辅助用药。

由于监管状态（尤其是 FDA 药品短缺清单和肽类的 503A 散装物质资格）经常变化，请将 get_fda_status 的输出视为起点，并在配制前对照 FDA 当前数据库进行确认。

---

许可证

MIT © 2026 Keith Schmidt, MD — Oak Longevity Institute

临床参考内容仅用于教育和决策支持，不构成医疗建议。请参阅 LICENSE 中的免责声明。