:

Qué hace

Este es un servidor MCP no oficial de OpenEvidence que reutiliza las cookies exportadas desde tu propia sesión de navegador iniciada en OpenEvidence. No inicia un navegador, no instala Playwright y no necesita una clave de API oficial de OpenEvidence.

Está diseñado para flujos de trabajo personales locales donde ya tienes acceso legal a OpenEvidence. No elude la autenticación, no elimina controles de acceso, no redistribuye contenido de OpenEvidence ni incluye datos de OpenEvidence en este repositorio.

Herramientas:

oe_ask y oe_article_get devuelven BibTeX en la respuesta MCP de forma predeterminada cuando se guardan artefactos. Pasa include_bibtex: false para mantener la respuesta más pequeña mientras se sigue escribiendo citations.bib en el disco.

Artefactos guardados:

Instalación rápida

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

Exporta las cookies desde una sesión de navegador iniciada en https://www.openevidence.com y colócalas aquí:

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

El archivo de cookies puede ser una matriz de cookies exportada por el navegador o un objeto de estado de almacenamiento con una matriz cookies.

Registrar con clientes MCP

Usa uno de estos.

Claude Code

make install-claude-global
claude mcp get openevidence

Lo que registra:

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

Comando manual equivalente:

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

~/.codex/config.toml manual:

[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

Comando manual equivalente:

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

Claude Desktop, Cursor, Cline, Continue

Usa esta forma de mcpServers:

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

Instalar en todas partes

make install-all

Esto registra el mismo servidor stdio local con Claude Code, Codex CLI y Gemini CLI.

Verificar

npm run check
npm test
npm run build
npm run smoke

Resultado de prueba esperado:

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

Los servidores stdio de MCP normalmente se inician bajo demanda cuando el cliente los comprueba o utiliza. No necesitan ejecutarse como un demonio separado.

Cómo hacer preguntas

Después del registro, pregúntale a tu cliente MCP en inglés sencillo y menciona OpenEvidence. El agente debería llamar a oe_ask automáticamente.

Ejemplos de prompts:

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.

La llamada MCP subyacente se ve así:

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

oe_ask devuelve:

• la carga útil del artículo de OpenEvidence

• article_id

• respuesta en markdown extraída como extracted_answer_raw

• rutas de archivos de artefactos

• BibTeX en línea como artifacts.bibtex

• archivos de citas guardados bajo el directorio de artefactos

Para obtener BibTeX de una respuesta anterior, pregunta:

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

Eso se asigna a oe_article_get:

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

Si la respuesta es demasiado grande, usa include_bibtex: false; el servidor seguirá escribiendo citations.bib en el disco.

Artefactos de citas

Las llamadas completadas a oe_ask y oe_article_get guardan artefactos bajo:

/tmp/openevidence-mcp/<article_id>/

En macOS, Node puede resolver /tmp a una ruta bajo /var/folders/.../T/.

Ejemplo de salida:

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

Comportamiento de validación de Crossref:

• Las citas con DOI se validan directamente con Crossref.

• Las citas sin DOI utilizan una consulta bibliográfica y se marcan como candidate, not_found o error.

• Las coincidencias de Crossref de baja similitud no se utilizan para sobrescribir los metadatos de BibTeX.

• Fuentes como las guías de NCCN pueden permanecer como metadatos locales de OpenEvidence porque Crossref a menudo no tiene una coincidencia autorizada.

Derechos de autor, marca registrada y exención de responsabilidad médica

Este proyecto no es oficial e independiente. No está afiliado, respaldado, patrocinado ni aprobado por OpenEvidence o sus propietarios. "OpenEvidence" y los nombres relacionados, logotipos, nombres de productos y contenido siguen siendo propiedad de sus respectivos dueños.

Este repositorio contiene solo código de conector. No incluye contenido protegido por derechos de autor de OpenEvidence, conjuntos de datos propietarios, resultados de modelos, cargas útiles de artículos, cookies de sesión o material de cuenta. Tu uso local de este servidor MCP puede crear archivos como answer.md, article.json y citations.bib; esos artefactos pueden contener contenido recuperado o derivado de tu sesión de cuenta de OpenEvidence. Trata esos archivos como privados a menos que tengas derecho a compartirlos.

Eres responsable de cumplir con los términos de OpenEvidence, las políticas institucionales, la ley de derechos de autor y cualquier regla de gobernanza de datos clínicos que se aplique a tu uso. No publiques cookies, tokens de cuenta, cargas útiles de artículos guardados, respuestas generadas, capturas de pantalla, texto de guías u otro contenido protegido/con derechos de autor a menos que tengas permiso u otra base legal válida.

Este software no es un consejo médico y no es un dispositivo médico. Es una herramienta de integración para un cliente MCP. Los médicos y usuarios calificados siguen siendo responsables de verificar los resultados con fuentes autorizadas y aplicar un juicio clínico independiente.

Actualización de cookies

Si la autenticación deja de funcionar:

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

Luego reinicia o abre una nueva sesión de cliente MCP si el proceso del servidor stdio antiguo sigue activo.

Objetivos de Make

Variables de entorno

Archivos del proyecto

• README.AI.md - manual de instalación del agente

• examples/codex-config.toml - configuración de Codex MCP

• examples/claude-desktop-config.json - configuración de JSON MCP

• src/citations.ts - extracción de citas, BibTeX, validación de Crossref

• src/cookies.ts - análisis de archivos de cookies

• src/server.ts - herramientas MCP

• test/citations.test.ts - pruebas unitarias

Licencia y atribución

Apache-2.0. Mantén LICENSE y NOTICE al redistribuir.

Basado en OpenEvidence MCP de Bakhtier Sizhaev: https://github.com/bakhtiersizhaev/openevidence-mcp