:

Funktionsweise

Dies ist ein inoffizieller OpenEvidence MCP-Server, der Cookies wiederverwendet, die aus Ihrer eigenen angemeldeten OpenEvidence-Browsersitzung exportiert wurden. Er startet keinen Browser, installiert kein Playwright und benötigt keinen offiziellen OpenEvidence-API-Schlüssel.

Er ist für lokale persönliche Arbeitsabläufe konzipiert, bei denen Sie bereits rechtmäßigen Zugriff auf OpenEvidence haben. Er umgeht keine Authentifizierung, entfernt keine Zugriffskontrollen, verbreitet keine OpenEvidence-Inhalte und enthält keine OpenEvidence-Daten in diesem Repository.

Tools:

oe_ask und oe_article_get geben standardmäßig BibTeX in der MCP-Antwort zurück, wenn Artefakte gespeichert werden. Übergeben Sie include_bibtex: false, um die Antwort kleiner zu halten, während citations.bib weiterhin auf die Festplatte geschrieben wird.

Gespeicherte Artefakte:

Schnelle Installation

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

Exportieren Sie Cookies aus einer angemeldeten https://www.openevidence.com Browsersitzung und legen Sie sie hier ab:

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

Die Cookie-Datei kann ein browser-exportiertes Cookie-Array oder ein Storage-State-Objekt mit einem cookies-Array sein.

Registrierung bei MCP-Clients

Verwenden Sie eine dieser Optionen.

Claude Code

make install-claude-global
claude mcp get openevidence

Was registriert wird:

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

Äquivalenter manueller Befehl:

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

Manuelle ~/.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

Äquivalenter manueller Befehl:

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

Claude Desktop, Cursor, Cline, Continue

Verwenden Sie diese mcpServers-Form:

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

Überall installieren

make install-all

Dies registriert denselben lokalen stdio-Server bei Claude Code, Codex CLI und Gemini CLI.

Überprüfung

npm run check
npm test
npm run build
npm run smoke

Erwartetes Smoke-Test-Ergebnis:

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

MCP-stdio-Server starten normalerweise bei Bedarf, wenn der Client sie überprüft oder verwendet. Sie müssen nicht als separater Daemon ausgeführt werden.

Wie man Fragen stellt

Fragen Sie nach der Registrierung Ihren MCP-Client in einfachem Englisch und erwähnen Sie OpenEvidence. Der Agent sollte oe_ask automatisch aufrufen.

Beispiel-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.

Der zugrunde liegende MCP-Aufruf sieht so aus:

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

oe_ask gibt Folgendes zurück:

• die OpenEvidence-Artikel-Payload

• article_id

• extrahierte Antwort-Markdown als extracted_answer_raw

• Artefakt-Dateipfade

• Inline-BibTeX als artifacts.bibtex

• gespeicherte Zitatdateien im Artefakt-Verzeichnis

Um BibTeX für eine frühere Antwort abzurufen, fragen Sie:

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

Das entspricht oe_article_get:

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

Wenn die Antwort zu groß ist, verwenden Sie include_bibtex: false; der Server schreibt weiterhin citations.bib auf die Festplatte.

Zitat-Artefakte

Abgeschlossene oe_ask- und oe_article_get-Aufrufe speichern Artefakte unter:

/tmp/openevidence-mcp/<article_id>/

Unter macOS kann Node /tmp in einen Pfad unter /var/folders/.../T/ auflösen.

Beispielausgabe:

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

Verhalten der Crossref-Validierung:

• DOI-Zitate werden direkt mit Crossref validiert.

• Nicht-DOI-Zitate verwenden eine bibliographische Abfrage und werden als candidate, not_found oder error markiert.

• Crossref-Übereinstimmungen mit geringer Ähnlichkeit werden nicht verwendet, um BibTeX-Metadaten zu überschreiben.

• Quellen wie NCCN-Leitlinien können als lokale OpenEvidence-Metadaten verbleiben, da Crossref oft keine maßgebliche Übereinstimmung hat.

Urheberrecht, Markenrecht und medizinischer Haftungsausschluss

Dieses Projekt ist inoffiziell und unabhängig. Es ist nicht mit OpenEvidence oder seinen Eigentümern verbunden, wird von diesen nicht unterstützt, gesponsert oder genehmigt. "OpenEvidence" und zugehörige Namen, Logos, Produktnamen und Inhalte bleiben Eigentum ihrer jeweiligen Eigentümer.

Dieses Repository enthält nur Connector-Code. Es enthält keine urheberrechtlich geschützten OpenEvidence-Inhalte, proprietären Datensätze, Modellausgaben, Artikel-Payloads, Sitzungscookies oder Kontomaterial. Ihre lokale Nutzung dieses MCP-Servers kann Dateien wie answer.md, article.json und citations.bib erstellen; diese Artefakte können Inhalte enthalten, die aus Ihrer OpenEvidence-Kontositzung abgerufen oder davon abgeleitet wurden. Behandeln Sie diese Dateien als privat, es sei denn, Sie haben das Recht, sie zu teilen.

Sie sind dafür verantwortlich, die Bedingungen von OpenEvidence, institutionelle Richtlinien, das Urheberrecht und alle Regeln zur Verwaltung klinischer Daten einzuhalten, die für Ihre Nutzung gelten. Veröffentlichen Sie keine Cookies, Kontotoken, gespeicherten Artikel-Payloads, generierten Antworten, Screenshots, Leitlinientexte oder andere geschützte/urheberrechtlich geschützte Inhalte, es sei denn, Sie haben eine Erlaubnis oder eine andere gültige Rechtsgrundlage.

Diese Software ist keine medizinische Beratung und kein Medizinprodukt. Es ist ein Integrationstool für einen MCP-Client. Kliniker und qualifizierte Benutzer bleiben dafür verantwortlich, Ausgaben anhand maßgeblicher Quellen zu überprüfen und unabhängiges klinisches Urteilsvermögen anzuwenden.

Cookie-Aktualisierung

Wenn die Authentifizierung nicht mehr funktioniert:

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

Starten Sie dann neu oder öffnen Sie eine neue MCP-Clientsitzung, falls der alte stdio-Serverprozess noch aktiv ist.

Make-Ziele

Umgebungsvariablen

Projektdateien

• README.AI.md - Agenten-Installations-Playbook

• examples/codex-config.toml - Codex MCP-Konfiguration

• examples/claude-desktop-config.json - JSON MCP-Konfiguration

• src/citations.ts - Zitatauswahl, BibTeX, Crossref-Validierung

• src/cookies.ts - Cookie-Datei-Parsing

• src/server.ts - MCP-Tools

• test/citations.test.ts - Unit-Tests

Lizenz und Namensnennung

Apache-2.0. Behalten Sie LICENSE und NOTICE bei der Weiterverbreitung bei.

Basierend auf OpenEvidence MCP von Bakhtier Sizhaev: https://github.com/bakhtiersizhaev/openevidence-mcp