HEORAgent MCP Server 是一个以 Model Context Protocol（MCP）服务器形式提供的 AI 驱动卫生经济学与结果研究（HEOR）智能体，托管在 GitHub 上。它面向制药、生物技术、CRO 及医学事务团队，旨在自动化并规范化 HEOR 工作流程。
用途 该工具用于支持卫生经济学与结果研究中的常见任务，包括跨多个数据源的文献综述、偏倚风险评估、EQ-5D 价值集影响估算、成本效果建模，以及为多个 HTA 机构准备申报材料。它强调可审计性与流程严谨性，适合需要形成 HTA 提交附录的场景。
主要能力
- 文献检索：literature_search 可并行检索 44 个数据源，每次调用返回来源选择表，显示使用了哪些来源及原因，便于 HTA 审计追踪。数据源覆盖 PubMed、ClinicalTrials.gov、bioRxiv/medRxiv、ChEMBL、Wiley Online Library、WHO GHO、World Bank、OECD Health、IHME GBD、All of Us、FDA Orange Book/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、ISPOR、OHE、EuroQol Group 等，共 10 个类别。
- 成本效果建模：cost_effectiveness_model 支持多状态 Markov 模型（默认）或分区生存分析（肿瘤领域），遵循 ISPOR 良好实践与 NICE 参考案例（3.5% 贴现率、半周期校正）。包含 PSA（1,000–10,000 次蒙特卡洛迭代、WTP 阈值下成本有效的概率）、OWSA（单因素敏感性分析及龙卷风图摘要）、CEAC（成本效果可接受曲线）、EVPI（完美信息期望值），以及针对 NHS（£25–35K/QALY，2026 年 4 月更新）、美国支付方（$100–150K）和社会阈值的 WTP 评估。
- 偏倚风险评估：根据 study_type 自动选择合适 Cochrane 工具（RoB 2 / ROBINS-I / AMSTAR-2），返回 rob_results 对象，可直接传递给 hta_dossier_prep，用结构化领域判断替代 GRADE 表中的启发式 RoB 估计。
- HTA 申报材料准备：hta_dossier_prep 可起草六种 HTA 框架的提交就绪章节，并包含差距分析，可接收 literature_search 和 cost_effectiveness_model 的输出。
- 药物警戒与工作流编排：pv_classify 可将计划研究归类为 EMA 药物警戒监管类别（PASS 强制/自愿、PAES、RMP Annex 4、DUS、主动监测登记、妊娠登记、自发报告、ICH E2E 计划），返回匹配的 GVP 模块、ENCePP 方案模板 ID、RMP 影响、FDA 类似物和提交义务；纯决策树，<200ms 响应。hta_dossier 支持药物警戒计划章节，可将 pv_classify 的分类结果传入。maic_workflow 可一次调用运行完整的 MAIC 发现+筛选流水线（ITC 可行性 + 并行 literature_search + 筛选 + RoB + 网络）。
- 活证据智能（v1.17.0–v1.23.0）：RWE 与真实世界安全性（rwe.method_select 研究设计选择、pv.comparative_safety 类级 FAERS 风格 AE 排名、evidence.triangulation RCT↔RWE 一致性）、受治理的社交聆听（rwe.social_listening_protocol + pv.social_listening_triage，GVP Module VI ICSR 分诊，不进行爬取）、单一事实来源（evidence.claim_registry 一次导入数据、evidence.consistency_check 检测漂移、publication.draft 复用声明）、活编排（evidence.gap_analysis、workflow.living_evidence、hta.living_gvd）。
- AI 透明度披露（v1.13.0，对齐 ISPOR ELEVATE-GenAI）：16 个工具接受 ai_disclosure_level 参数，HTA/监管工具默认 "submission"，分析工具默认 "standard"；可通过环境变量 HEORAGENT_DISCLOSURE_LEVEL=off|standard|submission 全局覆盖。
- 输出格式：所有工具支持 output_format：text（默认，Markdown 表格与标题）、json（结构化对象）、docx（Microsoft Word 文档，保存到磁盘并返回路径）。DOCX 保存至 ~/.heor-agent/projects/{project}/reports/（设置项目时）或 ~/.heor-agent/reports/（全局）。
- 审计记录：每次工具调用返回完整审计记录，含来源选择表、查询来源、纳入/排除计数与原因、方法论（文献为 PRISMA 风格，经济学为 ISPOR/NICE）、假设及理由、警告。适合纳入 HTA 提交附录。
- 知识库：项目位于 ~/.heor-agent/projects/{project-id}/，包含 raw/literature/、raw/models/、raw/dossiers/、reports/、wiki/（手动整理的 Obsidian 兼容 markdown，支持 [[wikilinks]]）。向任意工具传递 project: "project-id" 即可自动保存结果。
使用方式
- 客户端集成：支持 Claude Code、Claude Desktop / claude.ai Desktop、Cursor、Continue、Cline，均使用 stdio。配置方式：Claude Code 添加后重启；Claude Desktop 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）后重启；Cursor 在 Settings → MCP → Add new MCP server；Continue 在 ~/.continue/config.json 的 mcpServers 键下；Cline 在 Settings → MCP Servers → Edit MCP Settings。
- 快速验证：打开两个终端标签页，Tab 1 以 HTTP 模式启动服务器，Tab 2 确认响应。若看到预期 JSON 输出则 npm 包正常；若出现 command not found，需运行 node --version 确认 Node ≥20；其他错误可在 https://github.com/neptun2000/heor-agent-mcp/issues 提交问题。实际集成使用 stdio，无需 HTTP 模式。
- 托管使用：ChatGPT（Plus / Team）上可用 HEORAgent，输入 /heor 使用，适用于任何对话；Web UI（Claude，BYOK）位于 https://web-michael-ns-projects.vercel.app，需自备 Anthropic API 密钥，运行完整 v1.6.3 工具集。
- 自定义 GPT：v1.0.4 提供 OpenAPI 3.1 适配器 /api/openapi，可快速构建 Custom GPT。
- 安装命令：npx heor-agent-mcp（用于 Claude Desktop / Claude Code）。
适用场景 适合制药、生物技术、CRO 和医学事务团队，用于文献综述、间接比较（Bucher）、MAIC 人群调整比较、成本效果分析、预算影响分析、生存曲线拟合、证据网络与 NMA 可行性评估、偏倚风险评估、EQ-5D 5L 影响估算、EU JCA 及 NICE/ICER 等机构申报材料准备。文档提供了多个复制粘贴示例提示，覆盖单工具与多工具工作流。
限制 资料未提供具体收费与价格信息，暂未提供。使用 Web UI 需自备 Anthropic API 密钥。ChatGPT 集成需要 Plus / Team / Enterprise 账户。Node 版本需 ≥20。部分数据源可能需要 API 密钥（文档提示存在缺失 API 密钥的警告标记）。
