:

功能说明

这是一个非官方的 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

这会将同一个本地 stdio 服务器注册到 Claude Code、Codex CLI 和 Gemini CLI 中。

验证

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

• 提取出的答案 Markdown，作为 extracted_answer_raw

• 工件文件路径

• 内联 BibTeX，作为 artifacts.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 指南等来源可能会保留为本地 OpenEvidence 元数据，因为 Crossref 通常没有权威匹配项。

版权、商标和医疗免责声明

本项目是非官方且独立的。它不隶属于 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