HEORAgent MCPサーバー

Model Context Protocolサーバーとして機能する、AIを活用した医療経済・アウトカム研究（HEOR）エージェント。

41のデータソースを横断する文献レビューの自動化、最先端の費用対効果モデリング、NICE / EMA / FDA / IQWiG / HAS / EU JCA向けのHTAドシエ作成、そして永続的なプロジェクトナレッジベースを提供します。これらすべてをClaude.ai、Claude Code、およびMCP互換ホストから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のソースを並行して検索します。すべての呼び出しで、どのソースが使用され、その理由は何かが示されるソース選択テーブルが返されます。これは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

ISPORのグッドプラクティスおよびNICEリファレンスケース（3.5%割引率、半サイクル補正）に従った、マルチステートMarkovモデル（デフォルト）または分割生存分析（腫瘍学）。以下を含みます：

• PSA — 1,000〜10,000回のモンテカルロシミュレーション、WTP閾値における費用対効果の確率

• OWSA — トルネード図による一方向感度分析

• CEAC — 費用対効果受容曲線

• EVPI — 完全情報期待値

• WTP評価 — NHS（2026年4月改定、£25k〜35k/QALY）、米国支払者（$100k〜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

ギャップ分析を伴う、6つのHTAフレームワーク向けの提出準備が整ったセクションを草案します：

literature_search および cost_effectiveness_model からのパイプ出力を受け入れます。

ナレッジベースツール

プロジェクトは ~/.heor-agent/projects/{project-id}/ に保存され、以下が含まれます：

• raw/literature/ — 自動入力された文献検索結果

• raw/models/ — 自動入力されたモデル実行結果

• raw/dossiers/ — 自動入力されたドシエ草案

• reports/ — 生成されたDOCXファイル

• wiki/ — [[wikilinks]] を使用した、手動でキュレーションされたObsidian互換のマークダウン

任意のツールに project: "project-id" を渡すと、結果が自動的に保存されます。

データソース

9つのカテゴリーにわたる41のソース。 すべての literature_search 呼び出しには、使用/不使用のステータスとその理由を示すソース選択テーブルが含まれます。

• PubMed — 3,500万件以上の生物医学引用（NCBI E-utilities）

• ClinicalTrials.gov — NIH/NLM試験登録（CT.gov v2 API）

• bioRxiv / medRxiv — 生命科学および医学のプレプリント

• ChEMBL — 薬物生物活性、メカニズム、ADMET（EMBL-EBI）

• WHO GHO — WHO世界保健統計

• World Bank — 人口統計、マクロ経済、医療支出

• OECD Health — OECD保健統計（支出、労働力、アウトカム）

• IHME GBD — 世界疾病負担（204カ国のDALY、有病率）

• 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 (タイ)

• ISPOR — HEOR手法および会議抄録

出力形式

すべてのツールは output_format をサポートしています：

• text (デフォルト) — フォーマットされたテーブルと見出し付きのマークダウン

• 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 (Bring Your Own Key) — 設定にAnthropic APIキーを貼り付けます。キーはブラウザのlocalStorageに留まり、サーバーには保存されません

• スタイル付きテーブル、ライブ進捗タイマー付きツール呼び出しカードを備えたマークダウンレンダリング

• 一般的な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: 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

• Issues: https://github.com/neptun2000/heor-agent-mcp/issues