zotero-mcp

로컬 Zotero 라이브러리(~/Zotero/zotero.sqlite + storage/)를 Claude 같은 MCP 클라이언트에서 검색하고 읽을 수 있게 해 주는 MCP 서버입니다. DOI나 arXiv ID로 새 논문을 추가하는 기능도 있습니다.

• 읽기는 Zotero가 꺼져 있어도 동작합니다. DB를 임시 스냅샷으로 복사해서 읽으며, 원본 DB에는 절대 쓰지 않습니다.

• 추가는 실행 중인 Zotero 앱의 로컬 커넥터(127.0.0.1:23119, 브라우저 확장 "Save to Zotero"가 쓰는 경로)를 통해 Zotero가 직접 저장합니다. 그래서 Zotero 동기화와 WebDAV 파일 동기화가 그대로 동작합니다. Zotero가 꺼져 있으면 사용자에게 켜 달라고 요청합니다(MCP elicitation을 지원하는 클라이언트에서는 확인 창, 그 외에는 안내 메시지).

도구

본문은 Zotero가 만들어 둔 .zotero-ft-cache를 우선 사용하고, 캐시가 없으면 PDF/HTML에서 직접 추출합니다.

Related MCP server: zotero-mcp

설치 및 등록

uv가 필요합니다.

git clone https://github.com/ahnhyunjun417/zotero-mcp.git

Claude Code:

claude mcp add --scope user zotero -- uv run --directory "/path/to/zotero-mcp" zotero-mcp

Claude Desktop에서는 claude_desktop_config.json(Windows: %APPDATA%\Claude\)에 다음을 추가합니다:

{
  "mcpServers": {
    "zotero": {
      "command": "uv",
      "args": ["run", "--directory", "C:\\path\\to\\zotero-mcp", "zotero-mcp"]
    }
  }
}

환경 변수 (선택)

Zotero 동기화 설정의 "파일 다운로드"가 "동기화 시"(기본값)이면 모든 파일이 로컬에 있으므로 WebDAV 폴백은 필요 없습니다. "필요할 때"로 바꾸었거나 다른 PC에서 쓰는 경우에만 설정하세요. 비밀번호는 저장소가 아니라 MCP 클라이언트 설정의 env에만 넣으세요.

개인정보

• 라이브러리 내용은 외부 서버로 보내지 않습니다. 다만 도구 결과(검색 결과, 본문, 주석 등)는 MCP 클라이언트가 쓰는 LLM에 전달됩니다.

• 외부로 나가는 요청은 add_paper가 메타데이터와 PDF를 받을 때(arXiv, doi.org, 지정한 PDF URL), 그리고 WebDAV 폴백을 설정했을 때뿐입니다.

• DB 스냅샷은 OS 임시 폴더에 만들고, 서버가 종료되면 삭제합니다.