Zotero용 모델 컨텍스트 프로토콜 서버

이 프로젝트는 Zotero 용 모델 컨텍스트 프로토콜(MCP)을 구현하는 파이썬 서버로, AI 어시스턴트 내에서 Zotero 라이브러리에 접근할 수 있도록 합니다. MCP 클라이언트 에서 사용할 수 있도록 작지만 최대한 유용한 Zotero 상호작용 세트를 구현하는 것을 목표로 합니다.

특징

이 MCP 서버는 다음과 같은 도구를 제공합니다.

• zotero_search_items : 텍스트 쿼리를 사용하여 Zotero 라이브러리에서 항목을 검색합니다.
• zotero_item_metadata : 특정 Zotero 항목에 대한 자세한 메타데이터 정보를 가져옵니다.
• zotero_item_fulltext : 특정 Zotero 항목(예: PDF 내용)의 전체 텍스트를 가져옵니다.

이러한 정보는 모든 MCP 클라이언트나 MCP Inspector를 통해 검색하고 접근할 수 있습니다.

각 도구는 Zotero 항목에서 관련 정보가 포함된 서식이 지정된 텍스트를 반환하고, Claude와 같은 AI 도우미는 이를 순차적으로 사용하여 항목을 검색한 다음 메타데이터나 텍스트 콘텐츠를 검색할 수 있습니다.

설치

Claude Desktop과 함께 사용하려면 mcpServers 구성에 다음을 추가하세요.

지엑스피1

ZOTERO_LOCAL 설정은 플러그인을 로컬 Zotero API 로 가리키고 클라이언트와 동일한 컴퓨터에서 Zotero 7(또는 베타 버전, 아래 참고)을 실행해야 합니다.

Zotero 웹 API를 사용하려면 API 키를 생성하고 여기 Zotero 계정 설정에서 라이브러리 ID(일반적으로 사용자 ID)를 찾아야 합니다: https://www.zotero.org/settings/keys

다음 환경 변수는 구성 옵션을 제공합니다.

• ZOTERO_LOCAL=true : 로컬 Zotero API를 사용합니다(기본값: false, 아래 참고 사항 참조)
• ZOTERO_API_KEY : Zotero API 키(로컬 API에는 필요하지 않음)
• ZOTERO_LIBRARY_ID : Zotero 라이브러리 ID(사용자 라이브러리의 경우 사용자 ID이며 로컬 API에는 필요하지 않음)
• ZOTERO_LIBRARY_TYPE : 라이브러리 유형(사용자 또는 그룹, 기본값: 사용자)

[!중요] 로컬에서 전체 텍스트 API에 접근하려면 곧 출시될 Zotero 릴리스가 필요합니다. 그 전까지는 해당 기능을 사용하려면 Zotero 베타 빌드를 설치해야 합니다(2025년 3월 7일 기준). 자세한 내용은 https://github.com/zotero/zotero/pull/5004를 참조하세요.

개발

1. 이 저장소를 복제하세요
2. uv sync 실행하여 uv 로 종속성을 설치합니다.
3. 위의 환경 변수를 사용하여 프로젝트 루트에 .env 파일을 만듭니다.

로컬 개발을 위한 MCP 검사기 시작:

테스트 실행

테스트 모음을 실행하려면:

관련 문서

• https://modelcontextprotocol.io/tutorials/building-mcp-with-llms
• https://github.com/modelcontextprotocol/python-sdk
• https://pyzotero.readthedocs.io/en/latest/
• https://www.zotero.org/support/dev/web\_api/v3/start