조테로 MCP

Zotero MCP: 클로드의 연구 도서관

Zotero MCP는 모델 컨텍스트 프로토콜을 통해 Zotero 연구 라이브러리를 Claude 및 기타 AI 어시스턴트( Cherry Studio , Cursor 등)와 원활하게 연결합니다. 논문 토론, 요약, 인용 분석, PDF 주석 추출 등 다양한 기능을 제공합니다!

✨ 특징

🔍 도서관 검색

제목, 저자 또는 내용으로 논문, 기사 및 도서 찾기
여러 기준으로 복잡한 검색 수행
컬렉션, 태그 및 최근 추가 항목을 탐색하세요

📚 콘텐츠에 액세스하세요

모든 항목에 대한 자세한 메타데이터를 검색합니다.
전체 텍스트 콘텐츠 가져오기(가능한 경우)
첨부 파일, 메모 및 하위 항목에 액세스

📝 주석 작업

PDF 주석을 직접 추출하고 검색하세요
Zotero의 기본 주석에 액세스하세요
메모와 주석을 만들고 업데이트합니다.

🌐 유연한 접근 방법

오프라인 액세스를 위한 로컬 방식(API 키 필요 없음)
클라우드 라이브러리 액세스를 위한 웹 API
로컬 연구와 원격 협업 모두에 적합합니다.

🚀 빠른 설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 Zotero MCP를 자동으로 설치하는 방법:

지엑스피1

수동 설치

UV를 통해 설치

uv tool install "git+https://github.com/54yyyu/zotero-mcp.git"
zotero-mcp setup  # Auto-configure for Claude Desktop

pip를 통해 설치

pip install git+https://github.com/54yyyu/zotero-mcp.git
zotero-mcp setup  # Auto-configure for Claude Desktop

🖥️ 설정 및 사용

전체 문서는 Zotero MCP 문서 에서 확인할 수 있습니다.

요구 사항

파이썬 3.10+
Zotero 7+(전체 텍스트 액세스가 가능한 로컬 API용)
Claude Desktop 또는 호환 AI 어시스턴트

클로드 데스크탑용

구성

설치 후 다음 중 하나가 발생합니다.

자동 구성 (권장):
zotero-mcp setup
수동 구성 : claude_desktop_config.json 에 추가하세요:
{ "mcpServers": { "zotero": { "command": "zotero-mcp", "env": { "ZOTERO_LOCAL": "true" } } } }

용법

Zotero 데스크톱을 시작합니다(환경 설정에서 로컬 API가 활성화되어 있는지 확인하세요)
Claude Desktop 실행
Claude Desktop의 도구 인터페이스를 통해 Zotero-MCP 도구에 액세스하세요.

예시 프롬프트:

"내 도서관에서 머신 러닝 관련 논문을 검색하세요"
"기후 변화에 관해 내가 추가한 최근 기사를 찾아보세요"
"양자 컴퓨팅에 관한 논문의 주요 결과를 요약해 보세요"
"신경망에 관한 논문에서 모든 PDF 주석을 추출합니다."
"내 노트와 주석에서 '강화 학습'에 대한 언급을 검색하세요."

체리 스튜디오용

구성

설정 -> MCP 서버 -> MCP 구성 편집으로 이동하여 다음을 추가합니다.

{
  "mcpServers": {
    "zotero": {
      "name": "zotero",
      "type": "stdio",
      "isActive": true,
      "command": "zotero-mcp",
      "args": [],
      "env": {
        "ZOTERO_LOCAL": "true"
      }
    }
  }
}

그런 다음 "저장"을 클릭하세요.

Cherry Studio는 일반 설정 및 도구 선택을 위한 시각적 구성 방법도 제공합니다.

🔧 고급 구성

로컬 API 대신 웹 API 사용

웹 API를 통해 Zotero 라이브러리에 액세스하는 방법(원격 설정에 유용):

zotero-mcp setup --no-local --api-key YOUR_API_KEY --library-id YOUR_LIBRARY_ID

환경 변수

ZOTERO_LOCAL=true : 로컬 Zotero API를 사용합니다(기본값: false)
ZOTERO_API_KEY : Zotero API 키(웹 API용)
ZOTERO_LIBRARY_ID : Zotero 라이브러리 ID(웹 API용)
ZOTERO_LIBRARY_TYPE : 라이브러리 유형(사용자 또는 그룹, 기본값: 사용자)

명령줄 옵션

# Run the server directly
zotero-mcp serve

# Specify transport method
zotero-mcp serve --transport stdio|sse

# Get help on setup options
zotero-mcp setup --help

📑 PDF 주석 추출

Zotero MCP에는 고급 PDF 주석 추출 기능이 포함되어 있습니다.

직접 PDF 처리 : Zotero에서 아직 색인되지 않은 PDF 파일에서도 주석을 직접 추출합니다.
향상된 검색 : PDF 주석 및 코멘트 검색
이미지 주석 지원 : PDF에서 이미지 주석 추출
원활한 통합 : Zotero의 기본 주석 시스템과 함께 작동합니다.

최적의 주석 추출을 위해 Zotero용 Better BibTeX 플러그인을 설치하는 것이 좋습니다 . 주석 관련 기능은 주로 이 플러그인을 통해 테스트되었으며, 향후 출시될 예정입니다.

PDF 주석 기능을 처음 사용하면 필요한 도구가 자동으로 다운로드됩니다.

📚 사용 가능한 도구

검색 도구

zotero_search_items : 도서관 검색
zotero_advanced_search : 복잡한 검색 수행
zotero_get_collections : 컬렉션 목록
zotero_get_collection_items : 컬렉션에서 아이템 가져오기
zotero_get_tags : 모든 태그 나열
zotero_get_recent : 최근에 추가된 항목 가져오기

콘텐츠 도구

zotero_get_item_metadata : 자세한 메타데이터 가져오기
zotero_get_item_fulltext : 전체 텍스트 콘텐츠 가져오기
zotero_get_item_children : 첨부 파일 및 메모 가져오기

주석 및 메모 도구

zotero_get_annotations : 주석 가져오기(PDF 직접 추출 포함)
zotero_get_notes : Zotero 라이브러리에서 노트를 검색합니다.
zotero_search_notes : 노트 및 주석(PDF 추출 포함) 검색
zotero_create_note : 항목에 대한 새 메모를 만듭니다(베타 기능)

🔍 문제 해결

검색 결과가 없습니다 . Zotero가 실행 중이고 로컬 API가 활성화되어 있는지 확인하세요.
라이브러리에 연결할 수 없습니다 . 웹 API를 사용하는 경우 API 키와 라이브러리 ID를 확인하세요.
전체 텍스트를 사용할 수 없음 : 로컬 전체 텍스트 액세스를 위해 Zotero 7 이상을 사용하고 있는지 확인하세요.

📄 라이센스

MIT

Zotero MCP

Integrations