:

Что это делает

Это неофициальный MCP-сервер OpenEvidence, который повторно использует файлы cookie, экспортированные из вашей собственной сессии OpenEvidence в браузере. Он не запускает браузер, не устанавливает Playwright и не требует официального API-ключа OpenEvidence.

Он предназначен для локальных персональных рабочих процессов, где у вас уже есть законный доступ к OpenEvidence. Он не обходит аутентификацию, не снимает ограничения доступа, не распространяет контент OpenEvidence и не включает данные OpenEvidence в этот репозиторий.

Инструменты:

oe_ask и oe_article_get по умолчанию возвращают BibTeX в ответе MCP при сохранении артефактов. Передайте include_bibtex: false, чтобы уменьшить размер ответа, при этом файл citations.bib все равно будет записан на диск.

Сохраненные артефакты:

Быстрая установка

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

Экспортируйте файлы cookie из сессии браузера, в которой выполнен вход на https://www.openevidence.com, и поместите их сюда:

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

Затем перезапустите или откройте новую сессию MCP-клиента, если старый процесс stdio-сервера все еще активен.

Цели 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 при распространении.

Основано на OpenEvidence MCP от Bakhtier Sizhaev: https://github.com/bakhtiersizhaev/openevidence-mcp