HEORAgent MCP 服务器

npm version license node

作为模型上下文协议 (MCP) 服务器的 AI 驱动型卫生经济学与结果研究 (HEOR) 代理。

它可自动执行跨 41 个数据源的文献综述、最先进的成本效益建模、针对 NICE / EMA / FDA / IQWiG / HAS / EU JCA 的 HTA 档案准备，以及持久化的项目知识库——所有功能均可作为 MCP 工具从 Claude.ai、Claude Code 和任何兼容 MCP 的主机中调用。

专为制药、生物技术、CRO 和医学事务团队打造，他们需要严谨、可审计的 HEOR 工作流程，而无需从零开始构建基础设施。

快速入门

Claude Code

claude mcp add heor-agent -- npx heor-agent-mcp

然后重启 Claude Code。

Claude Desktop / claude.ai

添加到您的 MCP 配置中：

{
  "mcpServers": {
    "heor-agent": {
      "command": "npx",
      "args": ["heor-agent-mcp"]
    }
  }
}

验证

> Run a literature search for semaglutide cost-effectiveness in T2D using PubMed and NICE TAs

工具

工具	用途
`literature_search`	搜索 41 个数据源，并提供完整的 PRISMA 风格审计追踪
`cost_effectiveness_model`	带有 PSA、OWSA、CEAC、EVPI 的 Markov / PartSA / 决策树 CEA
`hta_dossier_prep`	起草针对 NICE、EMA、FDA、IQWiG、HAS 和 EU JCA 的提交文件
`project_create`	初始化持久化项目工作区
`knowledge_search`	跨项目 raw/ 和 wiki/ 树进行全文搜索
`knowledge_read`	读取项目知识库中的任何文件
`knowledge_write`	将汇编的证据写入项目 wiki（兼容 Obsidian）

`literature_search`

并行搜索 41 个来源。每次调用都会返回一个来源选择表，显示使用了 41 个来源中的哪些以及原因——这对 HTA 审计追踪至关重要。

调用示例：

{
  "query": "semaglutide cardiovascular outcomes type 2 diabetes",
  "sources": ["pubmed", "clinicaltrials", "nice_ta", "cadth_reviews", "icer_reports"],
  "max_results": 20,
  "output_format": "text"
}

`cost_effectiveness_model`

多状态 Markov 模型（默认）或分区生存分析 (PartSA)（肿瘤学），遵循 ISPOR 良好实践和 NICE 参考案例（3.5% 折现率，半周期校正）。包括：

PSA — 1,000–10,000 次蒙特卡洛模拟，在 WTP 阈值下的成本效益概率
OWSA — 带有龙卷风图摘要的单向敏感性分析
CEAC — 成本效益可接受性曲线
EVPI — 完全信息的期望值
WTP 评估 — 针对 NHS（£25–35K/QALY，2026 年 4 月更新）、美国支付方（$100–150K）和社会阈值的判定

调用示例：

{
  "intervention": "Semaglutide 1mg SC weekly",
  "comparator": "Sitagliptin 100mg daily",
  "indication": "Type 2 Diabetes Mellitus",
  "time_horizon": "lifetime",
  "perspective": "nhs",
  "model_type": "markov",
  "clinical_inputs": { "efficacy_delta": 0.5, "mortality_reduction": 0.15 },
  "cost_inputs": { "drug_cost_annual": 3200, "comparator_cost_annual": 480 },
  "utility_inputs": { "qaly_on_treatment": 0.82, "qaly_comparator": 0.76 },
  "run_psa": true,
  "output_format": "docx"
}

`hta_dossier_prep`

为六个 HTA 框架起草可提交的章节并进行差距分析：

机构	国家	提交类型
NICE	英国	STA, MTA, early_access
EMA	欧盟	STA, MTA
FDA	美国	STA, MTA
IQWiG	德国	STA, MTA
HAS	法国	STA, MTA
JCA	欧盟 (Reg. 2021/2282)	初始、更新、变更（带 PICO）

接受来自 literature_search 和 cost_effectiveness_model 的管道输出。

知识库工具

项目位于 ~/.heor-agent/projects/{project-id}/，包含：

raw/literature/ — 自动填充的文献搜索结果
raw/models/ — 自动填充的模型运行结果
raw/dossiers/ — 自动填充的档案草稿
reports/ — 生成的 DOCX 文件
wiki/ — 手动整理的、兼容 Obsidian 的 Markdown，支持 [[wikilinks]]

将 project: "project-id" 传递给任何工具，结果将自动保存。

数据源

涵盖 9 个类别的 41 个来源。 每次 literature_search 调用都包含一个来源选择表，显示每个来源的使用/未使用状态及原因。

PubMed — 3500 万+ 生物医学引文 (NCBI E-utilities)
ClinicalTrials.gov — NIH/NLM 试验注册库 (CT.gov v2 API)
bioRxiv / medRxiv — 生命科学和医学预印本
ChEMBL — 药物生物活性、机制、ADMET (EMBL-EBI)

WHO GHO — 世界卫生组织全球卫生观察站
World Bank — 人口统计、宏观经济、卫生支出
OECD Health — OECD 卫生统计（支出、劳动力、结果）
IHME GBD — 全球疾病负担（204 个国家的 DALYs、患病率）
All of Us — NIH 精准医学队列

FDA Orange Book — 药物批准和治疗等效性
FDA Purple Book — 许可生物制品和生物类似药

NICE TAs (英国) · CADTH (加拿大) · ICER (美国) · PBAC (澳大利亚)
G-BA AMNOG (德国) · IQWiG (德国) · HAS (法国)
AIFA (意大利) · TLV (瑞典) · INESSS (魁北克，加拿大)

CMS NADAC (美国药物采购成本)
PSSRU (英国单位成本) · NHS National Cost Collection · BNF (英国药物定价)
PBS Schedule (澳大利亚)

DATASUS · CONITEC · ANVISA (巴西)
PAHO (泛美区域) · IETS (哥伦比亚) · FONASA (智利)

HITAP (泰国)

来源	环境变量
Embase	`ELSEVIER_API_KEY`
ScienceDirect	`ELSEVIER_API_KEY`
Cochrane Library	`COCHRANE_API_KEY`
Citeline	`CITELINE_API_KEY`
Pharmapendium	`PHARMAPENDIUM_API_KEY`
Cortellis	`CORTELLIS_API_KEY`
Google Scholar	`SERPAPI_KEY`

ISPOR — HEOR 方法论和会议摘要

输出格式

所有工具均支持 output_format：

text (默认) — 带有格式化表格和标题的 Markdown
json — 用于下游工具的结构化对象
docx — Microsoft Word 文档，保存到磁盘，并在响应中返回路径

DOCX 文件保存到 ~/.heor-agent/projects/{project}/reports/（设置项目时）或 ~/.heor-agent/reports/（全局）。工具响应包含绝对路径——可随时附加到提交文件或与利益相关者共享。

审计追踪

每次工具调用都会返回完整的审计记录：

来源选择表 — 所有 41 个来源的使用/未使用状态及原因
查询来源 — 发送的查询、响应计数、状态、延迟
纳入/排除 — 带有原因的计数
方法论 — 文献采用 PRISMA 风格，经济学采用 ISPOR/NICE 风格
假设 — 记录每一项假设及其理由
警告 — 数据质量标志、缺失的 API 密钥、失败的来源

适合包含在 HTA 提交附录中。

配置

# Optional — enterprise data sources
ELSEVIER_API_KEY=...        # Embase + ScienceDirect
COCHRANE_API_KEY=...        # Cochrane Library
CITELINE_API_KEY=...        # Citeline
PHARMAPENDIUM_API_KEY=...   # Pharmapendium
CORTELLIS_API_KEY=...       # Cortellis
SERPAPI_KEY=...             # Google Scholar

# Optional — knowledge base location
HEOR_KB_ROOT=~/.heor-agent  # Default

# Optional — localhost proxy for enterprise APIs behind corporate VPN
HEOR_PROXY_URL=http://localhost:8787

# Optional — hosted tier (future)
HEOR_API_KEY=...

Web UI

配套聊天界面地址：

https://web-michael-ns-projects.vercel.app

与 Claude Opus 4.6 + 全部 7 个 HEOR 工具聊天
BYOK (自带密钥) — 在设置中粘贴您的 Anthropic API 密钥；它仅保留在浏览器的 localStorage 中，绝不会存储在我们的服务器上
Markdown 渲染，带有样式表格，带有实时进度计时器的工具调用卡片
常见 HEOR 工作流程的示例提示词

Web UI 调用 Railway 上托管的 MCP 服务器进行工具执行。无需设置——只需添加您的 API 密钥即可开始查询。

自托管 Web UI

cd web
npm install
echo "ANTHROPIC_API_KEY=sk-ant-..." > .env.local  # optional server-side fallback
npm run dev -- -p 3456

将 MCP_SERVER_URL 设置为指向您自己的 MCP 服务器实例（默认：公共 Railway 部署）。

HTTP 传输

服务器支持 stdio（默认，用于本地 MCP 客户端）和 Streamable HTTP（用于托管部署）。

# Stdio mode (default — for Claude Code, Claude Desktop)
npx heor-agent-mcp

# HTTP mode — for hosted deployment, Smithery, web UI backend
npx heor-agent-mcp --http                    # port 8787
MCP_HTTP_PORT=3000 npx heor-agent-mcp        # custom port

HTTP 端点：

POST/GET/DELETE /mcp — MCP Streamable HTTP 协议
GET /health — 健康检查
GET /.well-known/mcp/server-card.json — Smithery 发现

开发

git clone https://github.com/neptun2000/heor-agent-mcp
cd heor-agent-mcp
npm install
npm test          # 244 tests across 66 suites
npm run build     # Compile TypeScript to dist/
npm run dev       # Run with tsx (no build step)

要求： Node.js ≥ 20。

架构

┌────────────────────────────────────────────┐
│  MCP Host (Claude.ai / Claude Code / etc.) │
└────────────────┬───────────────────────────┘
                 │ stdio
┌────────────────▼──────────────────────────┐
│  heor-agent-mcp server                    │
│  ┌──────────────────────────────────────┐ │
│  │ 7 MCP tools (Zod-validated)          │ │
│  ├──────────────────────────────────────┤ │
│  │ DirectProvider (default)             │ │
│  │   ├─ 41 source fetchers              │ │
│  │   ├─ Audit builder + PRISMA trail    │ │
│  │   ├─ Markov / PartSA economic models │ │
│  │   ├─ Markdown + DOCX formatters      │ │
│  │   └─ Knowledge base (YAML + MD)      │ │
│  └──────────────────────────────────────┘ │
└───────────────────────────────────────────┘
                 │
    ┌────────────┴─────────────┐
    ▼                          ▼
┌────────────┐         ┌──────────────────┐
│ ~/.heor-   │         │ External APIs    │
│ agent/     │         │ (PubMed, NICE,   │
│ projects/  │         │  ICER, CADTH, …) │
└────────────┘         └──────────────────┘

许可证

MIT — 参见 LICENSE。

免责声明

所有输出均为初步结果，仅供研究参考。 在用于任何 HTA 提交、支付方谈判、监管备案或临床决策之前，结果必须由合格的卫生经济学家进行验证。此工具不能替代专业的 HEOR 专业知识。

分发

渠道	使用方法	费用承担
npm	`npx heor-agent-mcp`	用户的 Claude 订阅
Smithery	smithery.ai/servers/neptun2000-70zu/heor-agent-mcp	用户的 Claude 订阅
Web UI	web-michael-ns-projects.vercel.app	用户自己的 Anthropic API 密钥 (BYOK)
托管 MCP	`https://heor-agent-mcp-production.up.railway.app`	免费（仅限工具执行）

链接

npm: https://www.npmjs.com/package/heor-agent-mcp
GitHub: https://github.com/neptun2000/heor-agent-mcp
Smithery: https://smithery.ai/servers/neptun2000-70zu/heor-agent-mcp
Web UI: https://web-michael-ns-projects.vercel.app
问题反馈: https://github.com/neptun2000/heor-agent-mcp/issues

heor-agent-mcp