OpenEvidence MCP (쿠키 인증 포크)

기능

이것은 사용자의 로그인된 OpenEvidence 브라우저 세션에서 내보낸 쿠키를 재사용하는 비공식 OpenEvidence MCP 서버입니다. 브라우저를 실행하지 않으며, Playwright를 설치하지 않고, 공식 OpenEvidence API 키가 필요하지 않습니다.

이 도구는 이미 OpenEvidence에 합법적으로 접근할 수 있는 개인 로컬 워크플로우를 위해 설계되었습니다. 인증을 우회하거나, 접근 제어를 제거하거나, OpenEvidence 콘텐츠를 재배포하거나, 이 저장소에 OpenEvidence 데이터를 포함하지 않습니다.

도구:

oe_ask와 oe_article_get은 아티팩트가 저장될 때 기본적으로 MCP 응답에 BibTeX를 반환합니다. 응답 크기를 줄이면서 citations.bib를 디스크에 계속 쓰려면 include_bibtex: false를 전달하세요.

저장된 아티팩트:

빠른 설치

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

로그인된 https://www.openevidence.com 브라우저 세션에서 쿠키를 내보내어 여기에 넣으세요:

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

쿠키 파일은 브라우저에서 내보낸 쿠키 배열이거나 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

이것은 Claude Code, Codex CLI 및 Gemini CLI에 동일한 로컬 stdio 서버를 등록합니다.

확인

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

• extracted_answer_raw로 추출된 답변 마크다운

• 아티팩트 파일 경로

• artifacts.bibtex로 인라인 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 가이드라인과 같은 소스는 Crossref에 권위 있는 일치 항목이 없는 경우가 많으므로 로컬 OpenEvidence 메타데이터로 유지될 수 있습니다.

저작권, 상표 및 의료 면책 조항

이 프로젝트는 비공식적이며 독립적입니다. OpenEvidence 또는 그 소유자와 제휴, 보증, 후원 또는 승인되지 않았습니다. "OpenEvidence" 및 관련 이름, 로고, 제품 이름 및 콘텐츠는 각 소유자의 자산입니다.

이 저장소에는 커넥터 코드만 포함되어 있습니다. OpenEvidence 저작권 콘텐츠, 독점 데이터 세트, 모델 출력, 아티클 페이로드, 세션 쿠키 또는 계정 자료는 포함되어 있지 않습니다. 이 MCP 서버를 로컬에서 사용하면 answer.md, article.json, citations.bib와 같은 파일이 생성될 수 있습니다. 이러한 아티팩트에는 OpenEvidence 계정 세션에서 검색되거나 파생된 콘텐츠가 포함될 수 있습니다. 공유할 권리가 없는 한 해당 파일을 비공개로 취급하세요.

사용자는 OpenEvidence 약관, 기관 정책, 저작권법 및 사용에 적용되는 임상 데이터 거버넌스 규칙을 준수할 책임이 있습니다. 허가 또는 기타 유효한 법적 근거가 없는 한 쿠키, 계정 토큰, 저장된 아티클 페이로드, 생성된 답변, 스크린샷, 가이드라인 텍스트 또는 기타 보호/저작권 콘텐츠를 게시하지 마세요.

이 소프트웨어는 의학적 조언이 아니며 의료 기기가 아닙니다. MCP 클라이언트를 위한 통합 도구입니다. 임상의 및 자격을 갖춘 사용자는 권위 있는 출처와 비교하여 출력을 확인하고 독립적인 임상 판단을 적용할 책임이 있습니다.

쿠키 새로 고침

인증이 작동하지 않는 경우:

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 - 쿠키 파일 파싱

• src/server.ts - MCP 도구

• test/citations.test.ts - 단위 테스트

라이선스 및 저작자 표시

Apache-2.0. 재배포 시 LICENSE 및 NOTICE를 유지하세요.

Bakhtier Sizhaev의 OpenEvidence MCP 기반: https://github.com/bakhtiersizhaev/openevidence-mcp