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

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

✨ 특징

🔍 도서관 검색

• 제목, 저자 또는 내용으로 논문, 기사 및 도서 찾기

• 여러 기준으로 복잡한 검색 수행

• 컬렉션, 태그 및 최근 추가 항목을 탐색하세요

📚 콘텐츠에 액세스하세요

• 모든 항목에 대한 자세한 메타데이터를 검색합니다.

• 전체 텍스트 콘텐츠 가져오기(가능한 경우)

• 첨부 파일, 메모 및 하위 항목에 액세스

📝 주석 작업

• PDF 주석을 직접 추출하고 검색하세요

• Zotero의 기본 주석에 액세스하세요

• 메모와 주석을 만들고 업데이트합니다.

🌐 유연한 접근 방법

• 오프라인 액세스를 위한 로컬 방식(API 키 필요 없음)

• 클라우드 라이브러리 액세스를 위한 웹 API

• 로컬 연구와 원격 협업 모두에 적합합니다.

Related MCP server: Zotero MCP Server

🚀 빠른 설치

Smithery를 통해 설치

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

지엑스피1

수동 설치

UV를 통해 설치

pip를 통해 설치

🖥️ 설정 및 사용

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

요구 사항

• 파이썬 3.10+

• Zotero 7+(전체 텍스트 액세스가 가능한 로컬 API용)

• Claude Desktop 또는 호환 AI 어시스턴트

클로드 데스크탑용

구성

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

1. 자동 구성 (권장):

   zotero-mcp setup

2. 수동 구성 : claude_desktop_config.json 에 추가하세요:

   { "mcpServers": { "zotero": { "command": "zotero-mcp", "env": { "ZOTERO_LOCAL": "true" } } } }

용법

1. Zotero 데스크톱을 시작합니다(환경 설정에서 로컬 API가 활성화되어 있는지 확인하세요)

2. Claude Desktop 실행

3. Claude Desktop의 도구 인터페이스를 통해 Zotero-MCP 도구에 액세스하세요.

예시 프롬프트:

• "내 도서관에서 머신 러닝 관련 논문을 검색하세요"

• "기후 변화에 관해 내가 추가한 최근 기사를 찾아보세요"

• "양자 컴퓨팅에 관한 논문의 주요 결과를 요약해 보세요"

• "신경망에 관한 논문에서 모든 PDF 주석을 추출합니다."

• "내 노트와 주석에서 '강화 학습'에 대한 언급을 검색하세요."

체리 스튜디오용

구성

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

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

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

🔧 고급 구성

로컬 API 대신 웹 API 사용

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

환경 변수

• ZOTERO_LOCAL=true : 로컬 Zotero API를 사용합니다(기본값: false)

• ZOTERO_API_KEY : Zotero API 키(웹 API용)

• ZOTERO_LIBRARY_ID : Zotero 라이브러리 ID(웹 API용)

• ZOTERO_LIBRARY_TYPE : 라이브러리 유형(사용자 또는 그룹, 기본값: 사용자)

명령줄 옵션

📑 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