TL;DR

Zotero MCP는 Zotero 플러그인에 통합된 MCP 서버를 통해 AI 어시스턴트가 로컬 라이브러리를 직접 검색·추출·수정하도록 연결하는 플러그인-서버 통합 프로젝트입니다. 통신은 Streamable HTTP로 처리되며, 플러그인 환경설정에서 서버를 활성화하고 클라이언트 설정을 생성하면 Claude Desktop 등 AI 클라이언트와 즉시 연동됩니다. 의미 기반 검색은 OpenAI/Ollama embedding과 SQLite-vec 인덱스를 이용해 구현되어 키워드 일치가 아닌 개념 유사도 기반 탐색을 지원합니다. 설치는 .xpi 파일을 Zotero에 추가하는 방식이고 Zotero 7.0·Node.js 18+ 전제이며 모든 연산이 로컬에서 이루어져 프라이버시 측면에서 유리합니다.

핵심 포인트

• 이 저장소는 Zotero용 플러그인과 통합된 MCP 서버를 함께 제공하여 AI 클라이언트와 로컬 Zotero 라이브러리를 직접 연결하는 플러그인-확장형 프로젝트입니다. 플러그인 내부에 통합된 MCP 서버가 Streamable HTTP 프로토콜로 AI 클라이언트와 양방향 스트리밍 통신을 처리하고, 플러그인 환경설정에서 서버를 활성화하고 클라이언트 설정을 생성하는 방식으로 동작합니다. 이 구조는 별도 서버 프로세스 설치 없이 Claude Desktop, Cherry Studio, Cursor IDE 같은 AI 도구가 로컬 문헌 검색·추출·수정 기능에 접근하도록 해 줍니다.
• 주요 기능은 고급 검색(제목·저자·연도·태그·전체텍스트·불린 연산·relevance scoring), PDF 전체텍스트 추출과 노트·스냅샷 통합 추출, 색상·태그 기반 주석 검색과 분석, 컬렉션 브라우징 및 생성·수정 같은 쓰기 작업을 포함합니다. 의미 기반 검색을 위해 OpenAI와 Ollama embedding API 자동 감지와 SQLite-vec 기반 벡터 인덱싱을 지원하며, 인덱스 상태를 라이브러리 뷰에서 표시하고 컬렉션 단위로 색인 관리를 제공합니다. 이 조합은 키워드 일치에 의존하지 않는 개념 유사 문헌 탐색과 캐시된 전체텍스트 검색을 동시에 가능하게 하여 문헌 검토·주석 정리·지식 베이스 구축 작업에서 효용이 큽니다.
• 개발 및 배포 요구사항은 Zotero 7.0 이상과 Node.js 18+이며 플러그인 설치는 Releases에서 .xpi 파일을 받아 Tools→Add-ons로 설치하고 재시작한 뒤 Preferences에서 서버를 켜는 방식입니다. 기본 포트는 23120이며 플러그인에서 클라이언트 구성 생성 기능을 제공하므로 AI 클라이언트에 필요한 Streamable HTTP 설정을 복사·붙여넣기만 하면 연결이 됩니다. 공개 저장소 기준으로 stars 1069, forks 88의 활동성을 보여 주며 모든 연산이 로컬에서 이루어지는 설계로 데이터 프라이버시가 유지된다는 점이 실무 적용에서 장점입니다.

이미지 분석