OpenEvidence MCP

OpenEvidence MCP（非公式）

API キーは不要です。npm run login:session で一度認証すると、サーバーはローカルのブラウザープロファイルを再利用します。レジストリメタデータのバージョン 0.2.2 は、引き続き既存の npm パッケージ 0.2.1 を使用します。

OpenEvidence MCP は非公式の Model Context Protocol サーバーです。ご自身の認証済みブラウザーセッションを通じて、OpenEvidence を Codex、Claude Code、Claude Desktop、Cursor、Cline、Continue、その他の MCP 互換クライアントに接続します。

重要

このプロジェクトは非公式であり、OpenEvidence とは提携していません。医療上のアドバイスを提供するものではなく、アクセス制御を回避することもありません。適用される規約、プライバシー規則、臨床ガバナンス要件を遵守し、ご自身の OpenEvidence アカウントでのみ使用してください。

翻訳： Русский | Español | 简体中文 | 繁體中文（台灣） | 한국어 | हिन्दी

エージェントの導入とインストール

Codex、Claude Code、Cursor、その他のローカル AI コーディングエージェントをお使いですか？エージェントにセットアップ、コンパイル、ローカル MCP の設定をすべて任せることができます！

次の短いブートストラッププロンプトをコピーして、ローカルの AI コーディングアシスタントに貼り付けてください。

Please install OpenEvidence MCP for me: clone https://github.com/bakhtiersizhaev/openevidence-mcp, install dependencies, run build, auto-configure this MCP server in my local client (Claude Desktop/Codex/Cursor), guide me through the one-time Edge/Chrome login using `npm run login:session`, and run `npm run smoke` to verify. Keep everything strictly local and secure.

包括的な手順ごとのセットアップガイドとルールについては、docs/AGENT_INSTALL_PROMPT.md をご覧ください。

できること

OpenEvidence MCP はローカルの stdio MCP サーバーとして動作し、MCP クライアントが既存の OpenEvidence ブラウザーセッションを使用して、次の操作を行えるようにします。

• 保存済みセッションが認証済みかどうかを確認する；
• OpenEvidence の質問／記事履歴を一覧表示する；
• ID を指定して記事の全ペイロードを取得する；
• OpenEvidence に調査に関する質問をし、任意で完了まで待機する；
• 既存の OpenEvidence 記事をポーリングし、完了まで確認する。

OpenEvidence の公式 API トークンは不要です。

できないこと

• OpenEvidence と提携、推奨、承認されたものではありません。
• 医療上のアドバイスを提供したり、臨床的判断に取って代わったりするものではありません。
• 認証、ペイウォール、アクセス制御を回避しません。
• 認証情報を収集しません。
• ご利用のマシンからローカルリクエストを通じて OpenEvidence に送信する場合を除き、ブラウザーのセッション状態を外部に送信しません。
• 適切な人間による確認なしに、患者個別の診断や治療方針の決定に使用しないでください。

対象ユーザー

• 自身の OpenEvidence アカウントを使用する臨床医；
• 医学研究者；
• エビデンス調査のワークフローを構築する AI オペレーター；
• Codex、Claude、Cursor、Cline、Continue、または同様のクライアントとローカルツールを統合する MCP 開発者。

テスト済み／対象クライアント

このプロジェクトは、MCP 互換クライアントとローカルエージェントのワークフロー向けに設計されています。特に記載がない限り、このリポジトリで保守している設定例は、Codex および Claude スタイルのローカル設定のみです。

クライアント	状態	備考
OpenAI Codex / Codex CLI / Codex app	対象	推奨するローカル MCP ワークフローです。
Claude Code	対象	推奨するエージェントのワークフローです。
MCP に対応した Claude Desktop / Claude app	対象	ローカル MCP サーバーの設定です。
Cursor	互換	MCP 互換の IDE ワークフローです。
Cline	互換	VS Code のエージェントワークフローです。
Continue	互換	オープンソース IDE アシスタントのワークフローです。
MCP に対応した VS Code / GitHub Copilot 環境	実験的	ローカルの MCP 対応状況とクライアント設定によって異なります。
Windsurf / Zed / Replit / Sourcegraph スタイルの MCP ホスト	実験的	テスト済みでない限り、動作は保証されません。
Gemini CLI / Google Antigravity スタイルのエージェント環境	実験的	ウォッチリスト／エコシステム上の対象であり、保守対象の設定例ではありません。

ほかの MCP 互換ホストでも動作する可能性がありますが、このリポジトリの設定例は Codex および Claude スタイルのローカル MCP 設定を中心にしています。

機能

ツール	目的	認証が必要	副作用
oe_auth_status	保存済みの OpenEvidence ブラウザーセッションが認証済みかどうかを確認します。	はい。ローカルのブラウザープロファイルでログインしている必要があります。	なし。
oe_history_list	ページネーションと検索を任意で指定して、過去の OpenEvidence 記事を一覧表示します。include_raw=true を明示的に指定しない限り、プライバシーに配慮して情報を減らした一覧を返します。	はい。	なし。
oe_article_get	ID を指定して記事を取得し、正規化されたフィールド（status、is_complete、question、answer_text）を返します。生のペイロードを取得するには、include_raw=true を指定します。	はい。	なし。
oe_article_wait	既存の記事 ID を指定し、記事が完了するまで待機します。ノンブロッキングの oe_ask の後に便利です。	はい。	なし。
oe_ask	OpenEvidence のリサーチ質問を作成し、記事が完了するまで任意で待機します。	はい。	OpenEvidence アカウントに質問／記事を作成します。

エージェントのツール呼び出しに関する注意事項

MCP サーバーには、MCP プロンプトを公開するクライアント向けに、組み込みの指示と openevidence_research_workflow という名前のプロンプトが含まれています。

推奨するエージェントのワークフロー：

1. 認証状態が不明な場合は、oe_auth_status を呼び出します。
2. ユーザーが過去の OpenEvidence の作業や記事 ID を求めている場合に限り、oe_history_list を使用します。
3. すでに記事 ID がある場合は、oe_article_get を使用します。
4. 長いリサーチ質問の場合は、wait_for_completion=false を指定して oe_ask を呼び出し、その後、返された article_id を指定して oe_article_wait を呼び出します。
5. original_article_id は、実際に過去のやり取りを引き継ぐ場合にのみ使用します。スレッドの古いコンテキストが残らないよう、新しい質問では省略してください。
6. 出力はエビデンスリサーチのコンテキストとして扱い、医療上の助言、診断、臨床上の指示として扱わないでください。

関連コマンド：

コマンド	目的
npm run login:session	一度だけ行うログイン方法として推奨されています。ローカルの OpenEvidence MCP プロファイルを使って Chrome/Edge を開きます。
npm run login	ローカルのプロファイルも使用する、従来の開発用 Playwright ログインフローです。
npm run login:browser	Google SSO の問題をデバッグするための、従来のシステムブラウザーログイン／エクスポートフローです。
npm run smoke	認証と OpenEvidence への基本的な接続を確認します。

要件

• Node.js 20+
• npm 10+
• OpenEvidence アカウント
• macOS、Windows、または Linux
• Playwright がインストールする Chromium（npx playwright install chromium）

利用可能状況に関する注意

OpenEvidence を利用できるかどうかは、地域、アカウントの利用資格、および OpenEvidence のポリシーによって異なる場合があります。2026 年 5 月時点の公開資料では、米国の HCP/NPI を中心としたアクセスが確認されており、EU／英国では利用できないことが示されています。このプロジェクトは、これらの制限を回避しません。

参考情報：

• OpenEvidence ホームページ
• OpenEvidence API／製品ページ
• OpenEvidence プライバシーポリシー

クイックスタート

macOS

git clone https://github.com/bakhtiersizhaev/openevidence-mcp.git
cd openevidence-mcp
./scripts/setup-macos.sh
npm run login:session
npm run smoke

Ubuntu/Linux

git clone https://github.com/bakhtiersizhaev/openevidence-mcp.git
cd openevidence-mcp
./scripts/setup-ubuntu.sh
npm run login:session
npm run smoke

Windows PowerShell

git clone https://github.com/bakhtiersizhaev/openevidence-mcp.git
cd openevidence-mcp
.\scripts\setup-windows.ps1
npm run login:session
npm run smoke

ログインフロー

推奨される初回ログイン：

npm run login:session

このコマンドを実行すると、OpenEvidence MCP のローカルブラウザープロファイルを使って Chrome または Edge が開きます。ご自身のアカウントで OpenEvidence にサインインし、通常の OpenEvidence ページが読み込まれることを確認してから、そのブラウザーウィンドウを閉じてターミナルに戻り、Enter キーを押してください。

デフォルトのローカルプロファイルのパス：

• macOS/Linux：~/.openevidence-mcp/browser-profile
• Windows：%USERPROFILE%\.openevidence-mcp\browser-profile

MCP サーバーは、プロセスの実行中、この同じローカルプロファイルを再利用します。OpenEvidence への呼び出しのために、最小化されたローカルブラウザープロセスを起動する場合がありますが、拡張機能のインストール、公開ネットワークサービスの公開、Cookie のエクスポート、パスワードの入力要求は行いません。

従来の開発用フロー：

npm run login

従来のフローで Google サインイン時にブラウザーまたはアプリが安全でない可能性があると表示された場合は、代わりにセッションログインを使用してください。

npm run login:session

ブラウザープロファイルファイル、ストレージ状態ファイル、Cookie、アカウントの非公開情報が含まれるスクリーンショット、または患者を特定できる情報を共有しないでください。

MCP クライアントの設定

サーバーを登録する前にビルドしてください。

npm run build

自動セットアップ（推奨）

組み込みのインストーラーを使って、お使いのクライアントに OpenEvidence MCP サーバーを自動登録できます。

• Claude Desktop（claude-app）：

  npx openevidence-mcp install --client claude-app
  # or via npm shortcut:
  npm run install:claude-app
  

• Codex Desktop（codex-app）：

  npx openevidence-mcp install --client codex-app
  # or via npm shortcut:
  npm run install:codex-app
  

• Claude Code（claude-code）：

  npx openevidence-mcp install --client claude-code
  # or via npm shortcut:
  npm run install:claude-code
  

• Codex CLI（codex-cli）：

  npx openevidence-mcp install --client codex-cli
  # or via npm shortcut:
  npm run install:codex-cli
  

• Google Antigravity（antigravity）：

  npx openevidence-mcp install --client antigravity
  # or via npm shortcut:
  npm run install:antigravity
  

• Cursor（cursor）：

  npx openevidence-mcp install --client cursor
  # or via npm shortcut:
  npm run install:cursor
  

• Windsurf（windsurf）：

  npx openevidence-mcp install --client windsurf
  # or via npm shortcut:
  npm run install:windsurf
  

アンインストールするには、次のコマンドを実行してください。

npx openevidence-mcp uninstall --client <client-id>

---

手動セットアップ

Codex

~/.codex/config.toml に次の内容を追加してください。

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

Windows の例：

[mcp_servers.openevidence]
command = "node"
args = ["C:\\Users\\<user>\\openevidence-mcp\\dist\\server.js"]
startup_timeout_sec = 60

Claude Desktop

claude_desktop_config.json に次の内容を追加してください。

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

Cursor、Cline、Continue

お使いのクライアントが MCP サーバーのコマンド／引数の設定に対応している場合は、同じ stdio サーバー形式を使用してください。

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

設定例は examples/ にあります。

検証

npm run smoke

有効なセッションでの期待される結果：

• ok: true
• authenticated: true
• マスキングされた履歴のプレビュー

スモークテストが認証エラーで失敗した場合は、npm run login:session を再度実行してください。スモークテストには実際の OpenEvidence アカウントセッションが必要です。ローカルのセッションプロファイルがない場合、クリーンな CI 環境では成功しません。

デフォルトでは、スモークテストの出力ではアカウント情報と履歴の内容がマスキングされます。デバッグのためにアカウント／履歴の未加工ペイロードが必要な場合に限り、非公開のターミナルで npm run smoke -- --verbose を使用してください。

開発者向けチェック：

npm test
npm run build
npm run check

セキュリティに関する注意

• ブラウザープロファイル、storage-state.json、Cookie は秘密情報として扱ってください。
• .env、セッション状態、アカウント情報を含むスクリーンショット、または患者を特定できる情報をコミットしないでください。
• ご自身の OpenEvidence アカウントのみを使用してください。
• MCP クライアントの設定では、ご自身が管理するビルド済みローカルサーバーのパスを指定してください。
• 自律型エージェントのツール呼び出しを確認してから、臨床または業務のワークフローで出力を使用してください。
• 脆弱性の報告方法とサポート対象範囲については、SECURITY.md を参照してください。

トラブルシューティング

詳しい復旧手順については、docs/TROUBLESHOOTING.md を参照してください。

よくある対処方法：

• authenticated: false：npm run login:session を再実行してください。
• 従来のログインフローで Google からブラウザーが安全ではないと表示される：npm run login:session を実行してください。
• ブラウザーのインストールエラー：npx playwright install chromium を実行してください。
• MCP クライアントがサーバーを起動できない：npm run build が成功したことを確認し、dist/server.js には絶対パスを指定してください。
• Windows のパスに関する問題：JSON/TOML 内のバックスラッシュをエスケープするか、完全な絶対パスを使用してください。
• Node のエラー：node --version が 20 以上であることを確認してください。
• OpenEvidence の UI/API が変更された：サニタイズ済みのログを添えて、アカウントの非公開情報や患者情報を含めずに issue を作成してください。
• oe_ask で質問入力欄または送信ボタンが見つからない：OpenEvidence の UI が変更された可能性があります。サニタイズ済みのログを添えて、アカウントの非公開情報や患者情報を含めずに issue を作成してください。

ロードマップ

• ツールの説明を簡潔にし、エージェントが使いやすい内容にします。
• 設定とレスポンスの解析を中心にテストを追加します。
• セッションの詳細を公開せずに、スモークテストの診断を改善します。
• クライアントの設定形式の変化に合わせて、MCP クライアントのセットアップ例を追跡します。

ライセンスと帰属表示

Apache-2.0（LICENSE）＋NOTICE。

再配布、フォーク、または派生バージョンを作成する場合は、以下への帰属表示を維持してください。

• 原著作者：Bakhtier Sizhaev
• 元のリポジトリ：https://github.com/bakhtiersizhaev/openevidence-mcp

推奨する帰属表示の行：

Based on OpenEvidence MCP by Bakhtier Sizhaev - https://github.com/bakhtiersizhaev/openevidence-mcp

Star の履歴