Zotero MCP

by 54yyyu
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Connects to your Zotero research library, allowing you to search for papers, articles and books, retrieve metadata, access full-text content, and browse collections, tags, and recent additions.

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

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

🚀 빠른 설치

Smithery를 통해 설치

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

지엑스피1

pip를 통해 설치

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

✨ 특징

도서관 검색

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

콘텐츠에 액세스하세요

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

🖥️ 설정 및 사용

클로드 데스크탑용

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

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

요구 사항

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

Claude에서 Zotero 사용하기

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

예시 프롬프트:

  • "내 도서관에서 머신 러닝 관련 논문을 검색하세요"
  • "기후 변화에 관해 내가 추가한 최근 기사를 찾아보세요"
  • "양자 컴퓨팅에 관한 논문의 주요 결과를 요약해 보세요"

🔧 고급 구성

로컬 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

📚 사용 가능한 도구

검색 도구

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

📄 라이센스

MIT

ID: yfe03znm4t