Home

OpenEvidence MCP Wiki

從 Claude Code、Codex CLI、Claude Desktop、Cursor 等任何 MCP client 查詢 OpenEvidence——透過你自己已登入的瀏覽器分頁認證，不需要 API key。

這是什麼？

OpenEvidence 的 API 受到機器人偵測（DataDome）保護，會封鎖一般的伺服器端請求。本專案的解法：當 AI 工具向 OpenEvidence 提問時，請求會在你自己已登入的 OpenEvidence 瀏覽器分頁內執行，因此帶著真實的瀏覽器 session，不會被挑戰。

• 無 API key：你的瀏覽器登入就是唯一憑證
• 無 headless browser：不用 Playwright、不用 cookie 檔（預設路徑）
• 一個分頁、多個 session：relay 以共用 daemon 形式常駐，任意數量的 Claude / Codex session 都經由同一個登入分頁

運作架構

  Claude / Codex / 任何 MCP client
            │  提問（oe_ask）
            ▼
     openevidence-mcp  ──▶  relay daemon  ──▶  瀏覽器擴充功能  ──▶  你已登入的
       (stdio server)      127.0.0.1:8787      （執行 fetch）        OpenEvidence 分頁
            ▲              共用・自動啟動                                  │
            └──────────────────────── 回答 ◀──────────────────────────────┘

三個元件：

元件	位置	職責
MCP server	src/server.ts	對 MCP client 暴露 oe_* 工具（stdio）
Relay daemon	src/relay-daemon.ts	獨立常駐程序，擁有 port 8787，所有 session 共用
瀏覽器擴充功能	extension/	通用的「已認證 fetch 代理」，把請求放進真實分頁執行

擴充功能只與 openevidence.com 和本機 relay（127.0.0.1）通訊；relay 只監聽 localhost，不對外開放。

快速開始

git clone https://github.com/htlin222/openevidence-mcp.git
cd openevidence-mcp
make all      # 安裝依賴・建置 server + 擴充功能・註冊到 Claude / Codex

之後只剩一個手動步驟（瀏覽器動作無法腳本化）：

1. chrome://extensions → 開發人員模式 → Load unpacked → 選 extension/dist
2. 在該瀏覽器保持登入 openevidence.com，開著一個分頁
3. 啟動你的 AI 工具，server 會自動拉起 relay 並連上擴充功能

驗證：

curl -s http://127.0.0.1:8787/health   # 預期 {"ok":true,"connected":true,...}

主要工具

工具	用途
oe_ask	提問——預設 fire-and-forget（立即回傳 pending 的 article_id）
oe_article_get	依 id 取回文章與 citation artifacts；可 wait_for_completion 阻塞等待
oe_auth_status	經 relay 檢查 /api/auth/me 登入狀態
oe_history_list	讀取提問歷史
oe_collections_*	Collections 的列出／建立／加入／SQLite 鏡像同步／自動分類

完整清單與參數見 README。

Wiki 頁面導覽

• Maintenance — 日常維護：建置、relay daemon 管理、疑難排解、排程同步
• Roadmap — 路線圖：已完成的里程碑與後續方向
• Plan and Tech Debt — 進行中的計畫與已知技術債
• Lessons and Gotchas — 教訓與通則：複刻已認證網頁請求時反覆踩到的坑（與主題無關，可通用）

授權與免責

Apache-2.0。本專案為非官方、獨立開發，與 OpenEvidence 無任何隸屬或背書關係；僅含連接器程式碼，不含 OpenEvidence 內容或帳號資料。本軟體不是醫療建議也不是醫療器材，臨床使用者須自行以權威來源驗證輸出。基於 bakhtiersizhaev/openevidence-mcp。