:

機能

これは非公式のOpenEvidence MCPサーバーであり、ログイン済みのOpenEvidenceブラウザセッションからエクスポートされたCookieを再利用します。ブラウザを起動せず、Playwrightをインストールせず、公式のOpenEvidence APIキーも必要としません。

OpenEvidenceへの正当なアクセス権を既にお持ちの個人のローカルワークフロー向けに設計されています。認証のバイパス、アクセス制御の削除、OpenEvidenceコンテンツの再配布、またはこのリポジトリへのOpenEvidenceデータの組み込みは行いません。

ツール:

oe_ask と oe_article_get は、アーティファクトが保存される際、デフォルトでMCPレスポンスにBibTeXを返します。include_bibtex: false を渡すと、citations.bib をディスクに書き込みつつ、レスポンスを小さく保つことができます。

保存されるアーティファクト:

クイックインストール

git clone https://github.com/htlin222/openevidence-mcp.git
cd openevidence-mcp
npm install
npm run build

ログイン済みの https://www.openevidence.com ブラウザセッションからCookieをエクスポートし、ここに配置します:

cp /path/to/browser-cookies.json ./cookies.json
npm run login
npm run smoke

Cookieファイルは、ブラウザからエクスポートされたCookie配列、または cookies 配列を含むストレージ状態オブジェクトである必要があります。

MCPクライアントへの登録

以下のいずれかを使用してください。

Claude Code

make install-claude-global
claude mcp get openevidence

登録内容:

node /ABSOLUTE/PATH/openevidence-mcp/dist/server.js
OE_MCP_COOKIES_PATH=/ABSOLUTE/PATH/openevidence-mcp/cookies.json

Codex CLI

make install-codex-global
codex mcp get openevidence

同等の手動コマンド:

codex mcp add openevidence \
  --env OE_MCP_COOKIES_PATH="$PWD/cookies.json" \
  -- node "$PWD/dist/server.js"

手動での ~/.codex/config.toml 設定:

[mcp_servers.openevidence]
command = "node"
args = ["/ABSOLUTE/PATH/openevidence-mcp/dist/server.js"]
startup_timeout_sec = 60

[mcp_servers.openevidence.env]
OE_MCP_COOKIES_PATH = "/ABSOLUTE/PATH/openevidence-mcp/cookies.json"

Gemini CLI

make install-gemini-global
gemini mcp list

同等の手動コマンド:

gemini mcp add --scope user \
  -e OE_MCP_COOKIES_PATH="$PWD/cookies.json" \
  openevidence node "$PWD/dist/server.js"

Claude Desktop, Cursor, Cline, Continue

以下の mcpServers 形式を使用してください:

{
  "mcpServers": {
    "openevidence": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/openevidence-mcp/dist/server.js"],
      "env": {
        "OE_MCP_COOKIES_PATH": "/ABSOLUTE/PATH/openevidence-mcp/cookies.json"
      }
    }
  }
}

全体へのインストール

make install-all

これにより、Claude Code、Codex CLI、Gemini CLIに対して同じローカルstdioサーバーが登録されます。

検証

npm run check
npm test
npm run build
npm run smoke

期待されるスモークテスト結果:

{
  "ok": true,
  "authenticated": true
}

MCP stdioサーバーは通常、クライアントが確認または使用する際にオンデマンドで起動します。個別のデーモンとして実行する必要はありません。

質問の方法

登録後、MCPクライアントに対して平易な英語で質問し、OpenEvidenceについて言及してください。エージェントが自動的に oe_ask を呼び出すはずです。

プロンプトの例:

Use OpenEvidence to answer: DLBCL frontline treatment landscape NCCN v3.2026. Include citations and BibTeX.

Use OpenEvidence to compare Pola-R-CHP vs R-CHOP in untreated DLBCL. Include trial citations and BibTeX.

Use OpenEvidence to review current evidence for SGLT2 inhibitors in HFpEF. Include citations and BibTeX.

Use OpenEvidence to find guideline-supported anticoagulation options for cancer-associated thrombosis.

基盤となるMCP呼び出しは以下のようになります:

{
  "tool": "oe_ask",
  "arguments": {
    "question": "DLBCL frontline treatment landscape NCCN v3.2026",
    "wait_for_completion": true,
    "include_bibtex": true
  }
}

oe_ask は以下を返します:

• OpenEvidence記事のペイロード

• article_id

• extracted_answer_raw として抽出された回答のマークダウン

• アーティファクトのファイルパス

• artifacts.bibtex としてのインラインBibTeX

• アーティファクトディレクトリ下に保存された引用ファイル

以前の回答のBibTeXを取得するには、以下のように尋ねてください:

Use OpenEvidence to fetch article <ARTICLE_ID> and show the BibTeX.

これは oe_article_get にマッピングされます:

{
  "article_id": "<ARTICLE_ID>",
  "include_bibtex": true
}

レスポンスが大きすぎる場合は include_bibtex: false を使用してください。サーバーは引き続き citations.bib をディスクに書き込みます。

引用アーティファクト

完了した oe_ask および oe_article_get の呼び出しは、以下にアーティファクトを保存します:

/tmp/openevidence-mcp/<article_id>/

macOSでは、Nodeは /tmp を /var/folders/.../T/ 下のパスに解決する場合があります。

出力例:

answer.md
article.json
citations.json
citations.bib
crossref-validation.json

Crossref検証の動作:

• DOI引用はCrossrefで直接検証されます。

• DOI以外の引用は書誌クエリを使用し、candidate、not_found、または error としてマークされます。

• 類似度の低いCrossref一致は、BibTeXメタデータを上書きするために使用されません。

• NCCNガイドラインなどのソースは、Crossrefに信頼できる一致がないことが多いため、ローカルのOpenEvidenceメタデータのままになる場合があります。

著作権、商標、および医療免責事項

このプロジェクトは非公式かつ独立したものです。OpenEvidenceまたはその所有者と提携、推奨、後援、または承認されていません。「OpenEvidence」および関連する名称、ロゴ、製品名、コンテンツは、それぞれの所有者の財産です。

このリポジトリにはコネクタコードのみが含まれています。OpenEvidenceの著作権で保護されたコンテンツ、独自のデータセット、モデル出力、記事ペイロード、セッションCookie、またはアカウント資料は含まれていません。このMCPサーバーをローカルで使用すると、answer.md、article.json、citations.bib などのファイルが作成される場合があります。これらのアーティファクトには、OpenEvidenceアカウントセッションから取得または派生したコンテンツが含まれる可能性があります。共有する権利がない限り、これらのファイルは非公開として扱ってください。

OpenEvidenceの利用規約、組織のポリシー、著作権法、および使用に適用される臨床データガバナンス規則を遵守する責任はユーザーにあります。許可がある場合やその他の正当な法的根拠がない限り、Cookie、アカウントトークン、保存された記事ペイロード、生成された回答、スクリーンショット、ガイドラインのテキスト、またはその他の保護/著作権で保護されたコンテンツを公開しないでください。

本ソフトウェアは医療アドバイスではなく、医療機器でもありません。これはMCPクライアント用の統合ツールです。臨床医および資格のあるユーザーは、信頼できるソースと照らし合わせて出力を検証し、独立した臨床判断を下す責任を負います。

Cookieの更新

認証が機能しなくなった場合:

cp /path/to/fresh-browser-cookies.json ./cookies.json
npm run login

その後、古いstdioサーバープロセスがまだ生きている場合は、再起動するか、新しいMCPクライアントセッションを開いてください。

Makeターゲット

環境変数

プロジェクトファイル

• README.AI.md - エージェントインストールプレイブック

• examples/codex-config.toml - Codex MCP設定

• examples/claude-desktop-config.json - JSON MCP設定

• src/citations.ts - 引用抽出、BibTeX、Crossref検証

• src/cookies.ts - Cookieファイル解析

• src/server.ts - MCPツール

• test/citations.test.ts - ユニットテスト

ライセンスと帰属

Apache-2.0。再配布時は LICENSE および NOTICE を保持してください。

Bakhtier SizhaevによるOpenEvidence MCPに基づいています: https://github.com/bakhtiersizhaev/openevidence-mcp