Heor Agent

HEORAgent MCP サーバー

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

今すぐお試しください → ChatGPT の HEORAgent（ChatGPT Plus / Team） · Web UI（Claude、BYOK） · Claude Desktop / Claude Code では npx heor-agent-mcp を実行

44 のデータソースを対象にした文献レビュー、バイアスリスク評価（RoB 2 / ROBINS-I / AMSTAR-2）、EQ-5D バリューセットの影響推定、最先端の費用対効果モデリング、NICE / EMA / FDA / IQWiG / HAS / EU JCA 向けのHTA申請資料作成、永続的なプロジェクト用ナレッジベースを自動化します。Claude.ai、Claude Code、その他のMCP対応ホストからMCPツールとして呼び出せます。

インフラを一から構築せずに、厳密で監査可能なHEORワークフローを必要とする製薬、バイオテクノロジー、CRO、メディカルアフェアーズのチーム向けに開発されています。

---

最初の60秒

Claude / Cursor / Continue に接続する前に、インストールが正常に動作することを確認してください。ターミナルを2つ開きます。

タブ1 — HTTPモードでサーバーを起動します：

MCP_HTTP_PORT=8080 npx heor-agent-mcp@latest

次のように表示されます：

HEORAgent MCP server running on HTTP port 8080

タブ2 — 応答を確認します：

curl -s http://localhost:8080/health

想定される出力：

{"status":"ok","server":"heor-agent-mcp","version":"1.10.2"}

✅ 上記のJSONが表示されたら、お使いのマシンでnpmパッケージは動作しています。以降に問題が発生する場合は、MCPクライアントの設定（Claude Desktop / Cursor / Continue）に原因があり、サーバーの問題ではありません。

❌ command not found と表示された場合は、node --version を実行してください。Node ≥20 が必要です。別のエラーが表示された場合は、出力を添えて https://github.com/neptun2000/heor-agent-mcp/issues に簡単なIssueを登録してください。

タブ1を停止（Ctrl+C）し、以下からクライアントを選択してください。実際の連携にはHTTPモードは不要です。Claude / Cursor / Continueはいずれもstdioを使用します。

---

クイックスタート（クライアント別）

MCPホストを選択してください：

Claude Code

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

その後、Claude Codeを再起動します。

Claude Desktop / claude.ai Desktop

MCP設定ファイル（macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json）を編集し、次を追加します：

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

その後、Claude Desktopを再起動します。

Cursor / Continue / Cline

設定の形式は上記のClaude Desktopと同じですが、ファイルの場所はクライアントによって異なります：

• Cursor： Settings → MCP → Add new MCP server
• Continue： mcpServers キーの下にある ~/.continue/config.json
• Cline： Settings → MCP Servers → Edit MCP Settings

ホスト型（インストール不要）

• ChatGPT（Plus / Team）： ChatGPT の HEORAgent — /heor と入力して使用します。どの会話でも利用できます。
• Web UI（Claude、BYOK）： web-michael-ns-projects.vercel.app — Anthropic APIキーを用意してください。v1.6.3のツールセット全体を実行します。

---

最初のプロンプト

MCPホストの設定が完了したら、エンドツーエンドで動作を確認するために、次のいずれかを貼り付けてください：

Run a literature search for semaglutide cost-effectiveness in T2D
using PubMed, NICE TAs, and ICER reports. Set runs=2.

Run irb_review for an industry-funded interventional Phase 2 trial in
relapsed MM — multi-site US+EU, pseudonymized data, greater-than-minimal
risk. I need the review tier, GDPR/HIPAA DMP, SAE framework, and the
ready-to-paste cover letter.

Run jca_pico_scope for osimertinib in EGFR-mutant 2L NSCLC across
DE/FR/IT/ES/NL. Then prepare an EU JCA dossier draft using the picos.

1つ目のプロンプトでは literature_search と validate_links を実行します（無料、APIキー不要）。2つ目では irb_review を実行します（純粋な意思決定ツリーで、即座に動作します）。3つ目では jca_pico_scope → hta_dossier のパイプラインを実行します。

---

新着情報

完全なバージョン履歴については、CHANGELOG.md をご覧ください。現在のバージョン：v1.23.0（45 個のツール、44 個のデータソース）。

v1.17.0–v1.23.0 — 継続的なエビデンスインテリジェンス（レビュー → 償還）

RWE と複数の成果物をつなぐレイヤーです（全項目の表は docs/FEATURES.md をご覧ください）。

• 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（主張を再利用。CONSORT／STROBE／PRISMA／CHEERS + GPP2022／ICMJE）。
• 継続的なオーケストレーション： evidence.gap_analysis（iEGP）、workflow.living_evidence（SLR → 継続的に更新される KB → JCA／HTA ランブック）、hta.living_gvd（図表が変更された GVD のセクションのみを再生成）。

v1.13.0 — AI 透明性開示（ISPOR ELEVATE-GenAI に準拠）

16 個のツールで ai_disclosure_level パラメーターを指定できるようになりました。

値	動作
"off"	開示ブロックを追加しません
"standard"	モデル ID・呼び出したツール・データソース・日付・人間によるレビューの注意書き
"submission"	Standard ブロック + ISPOR ELEVATE-GenAI の完全な引用

ツール階層ごとのデフォルト： HTA／規制関連ツール（hta_dossier、hta_workflow、jca_pico_scope、pv_classify など）のデフォルトは "submission" です。分析ツール（risk_of_bias、cost_effectiveness_model など）のデフォルトは "standard" です。抑制するには ai_disclosure_level: "off" を指定してください。

環境レベルのデフォルト： HEORAGENT_DISCLOSURE_LEVEL=off|standard|submission を設定すると、組み込みのツールごとのデフォルトをグローバルに上書きできます。

Web UI のペルソナごとのデフォルト： 支払者および HTA レビュアーのペルソナでは常に "submission" を使用します。アナリストのペルソナのデフォルトは "standard" で、草案作成／探索的なプロンプトでは "off" に切り替わります。

v1.0.4 の主な更新（v1.6.3 に含まれています）

ファーマコビジランスとワークフローのオーケストレーション：

• pv_classify ツール — 計画中の試験を EMA のファーマコビジランス規制カテゴリー（PASS の義務付け／任意実施、PAES、RMP 附属書 4、DUS、アクティブサーベイランスレジストリ、妊娠レジストリ、自発報告、ICH E2E 計画）に分類します。一致する GVP モジュール（V／VI／VIII／VIII 追補 I）、ENCePP プロトコルテンプレート ID、RMP への影響、FDA の同等制度、提出義務を返します。EMA GVP 第 4 版および EU 規則 1235/2010 第 107a 条に基づく純粋な決定木です。応答時間は 200 ミリ秒未満です。
• hta_dossier のファーマコビジランス計画セクション — pv_classify の pv_classification を hta_dossier に渡すと、出力されるドシエに RoB と CEA の間の PV 計画セクションが含まれます。指定しない場合は、「PV 計画が提供されていません」という 1 行の注記が不足を示し、レビュー担当者が欠けている情報を確認できます。
• maic_workflow オーケストレーター (v1.0.6) — MAIC の探索・スクリーニングパイプライン全体（ITC の実行可能性評価 + 並列の literature_search + スクリーニング + RoB + ネットワーク）を 1 回の MCP 呼び出しで実行します。5 件以上のツール呼び出しを並列で連鎖させるのが不安定な ChatGPT-5.3 のインターフェース向けに構築されていますが、Claude からも同様に使用できます。
• examples ツール (v1.0.5) — 大規模なスキーマを持つツール（CEA、BIA、生存分析、MAIC、Bucher）向けの入力済み JSON と、ChatGPT ユーザー向けの複数ステップのプロンプトテンプレート maic_workflow_recipe を提供します。
• CMS IRA への対応 — pv_classify を米国の管轄区域で呼び出すと、CMS IRA の Medicare 価格交渉計算では PV のコストデータが除外されることを出力で明示します。これらの義務は HEOR の費用対効果モデルではなく、規制関連予算で管理してください。
• GRADE の I² に基づく不一致、GRADE の格上げ（Guyatt 2011）、Bucher 整合性チェック、EQ-5D 5L のベースライン効用を考慮した影響 (v1.0.4) — 詳細は CHANGELOG.md をご覧ください。
• ChatGPT Custom GPT のサポート (v1.0.4) — /api/openapi の OpenAPI 3.1 アダプターを使用すれば、5 分で Custom GPT を作成できます。以下の ChatGPT Custom GPT をご覧ください。
• インターフェース別の分析データ (v1.0.4) — すべての tool_call PostHog イベントに surface プロパティ（claude_anthropic_web / chatgpt_adapter / claude_desktop / direct_mcp）が含まれます。

変更の全容については CHANGELOG.md をご覧ください。

---

ツール（28）

ツール	目的
literature_search	44 のデータソースを検索し、完全な PRISMA 形式の監査証跡を提供します
screen_abstracts	PICO に基づく関連性スコアリングと研究デザインの分類
risk_of_bias	GRADE の RoB ドメイン要約を含む、Cochrane RoB 2／ROBINS-I／AMSTAR-2
evidence_network	治療比較ネットワークを構築し、NMA の実施可能性を評価します
evidence_indirect	Bucher 法および頻度論的 NMA を実施し、直接的な h2h エビデンスと自動整合性チェックを行います（NICE DSU TSD 18）
population_adjusted_comparison	母集団調整間接比較のための MAIC および STC
survival_fitting	KM データに 5 つのパラメトリック分布を適合させます（NICE DSU TSD 14）
itc_feasibility	ITC の 3 つの仮定からなるフレームワークを評価し、Bucher 法／NMA／MAIC／STC／ML-NMR を推奨します
cost_effectiveness_model	PSA、OWSA、CEAC、EVPI、EVPPI に対応した Markov／PartSA／決定木 CEA。QALY と evLYG に対応
budget_impact_model	年ごとの出力と治療の置き換えモデリングに対応した ISPOR 準拠の BIA
hta_dossier	NICE、EMA、FDA、IQWiG、HAS、EU JCA 向けの申請資料を作成します。rob_results が渡された場合、GRADE 表では構造化された RoB を使用します。heterogeneity_per_outcome が渡された場合、不整合性には I² を使用します。upgrading_per_outcome による**GRADE の格上げ（Guyatt 2011）**に対応しています
utility_value_set	EQ-5D-3L／5L の価値セット参照と、ベースライン効用値を考慮した Biz 2026 ICER 影響推定（英国 5L 移行）
validate_links	表示前に引用 URL を HTTP 検証します
project_create	永続的なプロジェクトワークスペースを初期化します
knowledge_search	プロジェクトの raw/ および wiki/ ツリーを全文検索します
knowledge_read	プロジェクトのナレッジベースから任意のファイルを読み取ります
knowledge_write	編集済みのエビデンスをプロジェクトの wiki に書き込みます（Obsidian 互換）

literature_search

44 のソースを並列検索します。呼び出すたびに、使用したソースとその理由を示すソース選択表が返されます。これは 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 モデル（デフォルト）または Partitioned Survival Analysis（腫瘍領域）です。以下が含まれます。

• 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

6 つの HTA フレームワーク向けに、ギャップ分析を含む申請用セクションを作成します。

機関	国	申請の種類
NICE	英国	STA、MTA、early_access
EMA	EU	STA、MTA
FDA	米国	STA、MTA
IQWiG	ドイツ	STA、MTA
HAS	フランス	STA、MTA
JCA	EU（規則 2021/2282）	初回、更新、変更（PICO を含む）

literature_search と cost_effectiveness_model のパイプ出力を受け付けます。

risk_of_bias

study_type から自動検出した研究タイプに応じて、適切な Cochrane の評価ツールを使用し、バイアスリスクを評価します。

研究タイプ	評価ツール
RCT	RoB 2（5 ドメイン：ランダム化、逸脱、欠測データ、測定、報告）
観察研究	ROBINS-I（7 ドメイン：交絡、選択、分類、逸脱、欠測データ、測定、報告）
システマティックレビュー	AMSTAR-2（16 項目、重大と非重大）

hta_dossier_prep に直接渡せる rob_results オブジェクトを返します。GRADE 表のヒューリスティックな RoB 推定を、構造化されたドメイン評価に置き換えます。

呼び出し例：

{
  "studies": [{ "id": "pmid_1", "study_type": "RCT", "title": "...", "abstract": "..." }],
  "output_format": "json"
}

パイプライン：

literature_search → screen_abstracts → risk_of_bias → hta_dossier_prep

ナレッジベースツール

プロジェクトは ~/.heor-agent/projects/{project-id}/ に保存されます。

• raw/literature/ — 自動で格納される文献検索結果
• raw/models/ — 自動で格納されるモデルの実行結果
• raw/dossiers/ — 自動で格納されるドシエのドラフト
• reports/ — 生成された DOCX ファイル
• wiki/ — 手動で整理された、Obsidian 互換の [[wikilinks]] を含む Markdown

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

---

使用例

Claude Code、Claude Desktop、またはウェブ UIで試せる、コピーして貼り付けるプロンプトです。

単一ツールの使用例

文献検索

2 型糖尿病におけるチルゼパチドの心血管アウトカムについて文献を検索してください。PubMed、ClinicalTrials.gov、NICE TAsを使用してください。

生存曲線の当てはめ

KEYNOTE-189の次のOSデータに生存曲線を当てはめてください。時点0の生存率1.0、時点6の生存率0.88、時点12の生存率0.72、時点18の生存率0.60、時点24の生存率0.51、時点36の生存率0.38です。単位は月です。

予算影響分析

肥満に対するセマグルチドのNHSにおける5年間の予算影響を推定してください。適格患者数は200,000人、薬剤費は年間£1,200、比較対照（オルリスタット）は年間£250、普及率は1年目の15%から5年目の40%までとします。

費用対効果モデル

2 型糖尿病におけるセマグルチド対シタグリプチンの費用対効果（CE）モデルを、NHSの視点、ライフタイム期間、PSAありで構築してください。

間接比較（Bucher法）

2つの試験があります。SUSTAIN-1では、HbA1cについてセマグルチド対プラセボのHRが0.74（0.58-0.95）、AWARD-5では、デュラグルチド対プラセボのHRが0.78（0.65-0.93）でした。セマグルチドとデュラグルチドのBucher法による間接比較を実施してください。

MAIC（集団調整比較）

SUSTAIN-7（N=300、セマグルチド対プラセボ、HR 0.74、CI 0.58-0.95、年齢56±10歳、BMI 33±5）とAWARD-11（N=600、デュラグルチド対プラセボ、HR 0.78、CI 0.65-0.93、年齢58±9歳、BMI 35±6）の間でMAICを実施してください。年齢とBMIで調整してください。

複数ツールのワークフロー

抄録スクリーニングのワークフロー

NSCLCにおけるペムブロリズマブについてPubMedを検索し、NSCLCの成人を対象に、ペムブロリズマブと化学療法を比較し、全生存期間とPFSをアウトカムとする条件で検索結果をスクリーニングしてください。

エビデンスネットワーク＋NMA実施可能性

PubMedを使って2 型糖尿病におけるGLP-1受容体作動薬を検索し、検索結果からエビデンスネットワークを構築して、NMAの実施可能性を評価してください。

シナリオ付きCEモデル

心不全に対するダパグリフロジン対プラセボのCEモデルを、NHSの視点、ライフタイム期間、PSAありで構築してください。次のシナリオを追加してください。「20%の価格引き下げ」では薬剤費を400、「10年間の期間」ではtime_horizonを10yrとします。

エンドツーエンドのHTAワークフロー

ドシエの完全な準備

NICEとICERを対象として、肥満に対するセマグルチドのプロジェクトを作成してください。エビデンスを文献検索し、肥満の成人を対象に、減量アウトカムについてセマグルチドとプラセボを比較する条件で検索結果をスクリーニングし、スクリーニングした研究のバイアスリスクを評価してから、スクリーニング結果とrob_resultsを使ってNICE STAドシエのドラフトを作成してください。

この1つのプロンプトで、project_create → literature_search → screen_abstracts → risk_of_bias → hta_dossier_prep（構造化評価に基づくGRADE RoB）を実行します。

---

データソース

10カテゴリにわたる44のソース。 literature_search を呼び出すたびに、各ソースの使用・未使用の状況と理由を示す選択テーブルが含まれます。

生物医学・臨床試験（5）

• PubMed — 3,500万件以上の生物医学分野の引用文献（NCBI E-utilities）
• ClinicalTrials.gov — NIH/NLM の臨床試験レジストリ（CT.gov v2 API）
• bioRxiv / medRxiv — 生命科学および医学分野のプレプリント
• ChEMBL — 薬剤の生物活性、作用機序、ADMET（EMBL-EBI）
• Wiley Online Library — 薬剤経済学、医療経済学、Journal of Medical Economics、Value in Health（CrossRef、抄録の約77％を収録、キー不要）

疫学・人口統計（5）

• WHO GHO — WHO 世界保健統計
• World Bank — 人口統計、マクロ経済、医療費
• OECD Health — OECD の保健統計（医療費、医療従事者、医療成果）
• IHME GBD — 疾病負担の世界的調査（204か国のDALY、有病率）
• All of Us — NIH の精密医療コホート

FDA（2）

• FDA Orange Book — 医薬品の承認と治療学的同等性
• FDA Purple Book — 承認済み生物製剤とバイオシミラー

HTA 評価（10）— HTA の先例となる決定

• NICE TAs（英国） · CADTH（カナダ） · ICER（米国） · PBAC（オーストラリア）
• G-BA AMNOG（ドイツ） · IQWiG（ドイツ） · HAS（フランス）
• AIFA（イタリア） · TLV（スウェーデン） · INESSS（カナダ、ケベック州）

HTA コスト参照データ（5）

• CMS NADAC（米国の医薬品取得費用）
• PSSRU（英国の単位コスト） · NHS National Cost Collection · BNF（英国の医薬品価格）
• PBS Schedule（オーストラリア）

LATAM（6）

• DATASUS · CONITEC · ANVISA（ブラジル）
• PAHO（パンアメリカ地域） · IETS（コロンビア） · FONASA（チリ）

APAC（1）

• HITAP（タイ）

エンタープライズ（6）— API キーが必要

ソース	環境変数
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

HEOR 方法論・効用値の参照情報（3）

• ISPOR — HEOR の方法論と学会抄録
• OHE (Office of Health Economics) — EQ-5D の価値セット研究と HEOR の方法論
• EuroQol Group — EQ-5D の評価尺度、価値セット、レジストリ

---

出力形式

すべてのツールで output_format を指定できます。

• text（デフォルト）— 表や見出しで整形された Markdown
• json — 後続のツール向けの構造化オブジェクト
• docx — Microsoft Word 文書。ディスクに保存され、パスが応答で返されます

DOCX ファイルは ~/.heor-agent/projects/{project}/reports/（プロジェクトが設定されている場合）または ~/.heor-agent/reports/（グローバル）に保存されます。ツールの応答には絶対パスが含まれ、申請資料への添付や関係者との共有にすぐ利用できます。

---

監査証跡

すべてのツール呼び出しで、完全な監査記録が返されます。

• ソース選択テーブル — 使用・未使用の状況と理由を含む全44のソース
• 照会したソース — 送信したクエリ、応答数、ステータス、レイテンシ
• 採用・除外 — 理由付きの件数
• 方法論 — 文献調査では 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 Sonnet 4.6 と 22 個すべての HEOR ツールを使ってチャットできます
• BYOK（Bring Your Own Key） — 設定に Anthropic API キーを貼り付けます。キーはブラウザーの localStorage に保存され、サーバーには保存されません
• スタイル付きテーブル、進行状況をリアルタイムで表示するツール呼び出しカード、テーマに対応した mermaid ネットワーク図を備えた Markdown レンダリング
• 文献検索、CEA、BIA、NMA、ITC の実施可能性、RoB、EQ-5D 5L、EU JCA の申請資料を網羅する 12 個のプロンプト例
• リクエストごとに MCP セッションを使用（ユーザー間でセッションが混在しません）

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 デプロイ）。

---

ChatGPT Custom GPT

🟢 公開中： ChatGPT の HEORAgent →

ChatGPT（Plus／Team／Enterprise アカウントが必要）で開き、会話のきっかけを選ぶと、44 個の HEOR データソースにクエリできます。

HEORAgent は ChatGPT Custom GPT としても利用できます。ChatGPT のインターフェースを使いたい場合や、ChatGPT Plus／Team アカウントはあるものの Anthropic API にアクセスできない場合に便利です。

内部では、Web 層が /api/openapi で OpenAPI 3.1 アダプターを公開し、各ツールに対して /api/v1/{tool_name} に POST エンドポイントを 1 つずつ提供します。ChatGPT はこの仕様にネイティブで対応しています。

Anthropic 側のインターフェースとの違い

	Web UI／MCP／Claude Desktop	ChatGPT Custom GPT
ストリーミング	はい（SSE）	いいえ（45 秒の単一レスポンス）
psa_iterations	最大 10,000	最大 1,000（CEA）／500（BIA）
literature_search.runs	1～5	最大 1
literature_search.max_results	最大 100	最大 30
認証方式	BYOK Anthropic	任意の X-API-Key ヘッダー（サーバー側の CHATGPT_ADAPTER_TOKEN）
PostHog でのインターフェースラベル	claude_anthropic_web／claude_desktop	chatgpt_adapter

この上限は、ChatGPT Actions が 45 秒のレスポンスタイムアウトで失敗するために設けられています。PSA、複数回の文献検索、max_results の最大値を指定した検索は、通常この制限を超えてしまいます。Web UI と MCP クライアントには影響しません。

Custom GPT の作成（ChatGPT Plus／Team が必要）

1. chatgpt.com/gpts/editor にアクセスし、作成をクリックします。
2. Configure タブで、名前（例：「HEORAgent」）、説明、会話のきっかけを入力します。web/lib/claude.ts のシステムプロンプトを貼り付けます（または独自のものを作成します。ツールの説明から機能を確認できます）。
3. Actions → Create new action → Import from URL の順に選択し、以下を貼り付けます。

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

   ChatGPT がスキーマを含む 17 個すべてのエンドポイントを自動的にインポートします。
4. Authentication — 公開エンドポイントをそのまま使う場合は None を選択します。CHATGPT_ADAPTER_TOKEN を設定している場合は、API Key を選び、その値を入力します（本番環境ではこちらを推奨します）。
5. Privacy policy URL — GPT Store で必須です。Web UI のプライバシー URL または独自の URL を使用します。
6. 右側のプレイグラウンドでテストし、Publish → 「Anyone with the link」または「GPT Store」を選択します。

本番環境でのアダプターの保護

デフォルトでは、/api/v1/* エンドポイントは認証なしで利用できます。一般公開する GPT には、次の 2 段階の保護を推奨します。

# 1. Token-gate the endpoint
cd web
vercel env add CHATGPT_ADAPTER_TOKEN production   # generate a long random token
# Configure the same token in your Custom GPT under Authentication → API Key

# 2. Built-in rate limit
# 60 req/min per IP is enforced automatically (lib/rateLimit.ts).
# For multi-region/high-traffic prod, swap in @upstash/ratelimit + Vercel KV.

呼び出し例（GPT 不要、手動で実行）

curl -X POST https://web-michael-ns-projects.vercel.app/api/v1/utility_value_set \
  -H "Content-Type: application/json" \
  -d '{
        "action": "estimate_impact",
        "indication_type": "non_cancer_qol_only",
        "baseline_utility": 0.85,
        "base_icer": 30000
      }'

Biz 2026 のベースライン効用で調整した ICER の予測値（新しい EQ-5D 5L 影響推定ツール）が返されます。

---

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          # 401 tests across 84 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                    │
│  ┌──────────────────────────────────────┐ │
│  │ 17 MCP tools (Zod-validated)         │ │
│  ├──────────────────────────────────────┤ │
│  │ DirectProvider (default)             │ │
│  │   ├─ 44 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 を参照してください。

---

信頼性と透明性

HEORAgent は研究・分析ツールであり、臨床意思決定支援システムではありません。個人の診断、治療、モニタリングを行うものではないため、EU AI Act における高リスクには分類されず、限定的なリスクに関する透明性義務のみが適用されます。すべての出力は、何らかの措置を講じる前に、資格を有する HEOR／HTA／PV の専門家が確認することを前提としています。

• EU AI Pact 署名者 — AI ガバナンス、高リスクシステムのマッピング、AI リテラシーの推進に取り組んでいます（AI Act の 2026 年 8 月の期限に先立ち、欧州委員会に対して行う自主的な取り組みです）。
• すべてのツール呼び出しにPRISMA 形式の監査証跡を記録します（照会した情報源、成功・失敗、適用した前提）。
• AI による解説は明示的にラベル付けされます — 領域に関する主張（ICER、試験結果、規制当局の決定）はツールの出力のみを情報源とし、学習データの記憶から生成することはありません。
• 方法論を本文中に引用しています — ISPOR、NICE DSU TSDs、NICE PMG36、Cochrane Handbook、GRADE、EMA GVP、Cope 2014、Phillippo 2016、Biz 2026。

詳細な声明：/ai-transparency — リスク分類、人間による監督モデル、方法論の参考文献、報告窓口をご確認いただけます。

---

免責事項

すべての出力は暫定的なものであり、研究の方向づけのみを目的としています。 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）
Hosted MCP	https://heor-agent-mcp-production.up.railway.app	無料（ツールの実行のみ）

---

リンク

• npm： https://www.npmjs.com/package/heor-agent-mcp
• GitHub： https://github.com/neptun2000-70zu/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-70zu/heor-agent-mcp/issues