zotero-mcp

概述

Zotero MCP 是一个通过模型上下文协议将 AI 助手直接连接到本地 Zotero 文献库的集成工具。该插件采用统一架构，集成了基于可流式 HTTP 协议的 MCP 服务器，无需单独的服务器进程。它提供多维文献检索、PDF 内容提取、批注分析、集合管理、基于嵌入向量的语义搜索以及笔记、标签和元数据的写入操作等功能。系统同时提供中英文文档，为学术研究和写作提供高效便捷的体验。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• search_libraryq, title, titleOperator, yearRange, fulltext, fulltextMode, itemType, includeAttachments, mode, relevanceScoring, sort, limit, offset

  Advanced library search with multi-dimensional filtering and relevance scoring

  试试:Find papers about machine learning from 2020-2023试试:Search all documents containing 'neural networks' in full text
• search_annotationsq, itemKeys, types, colors, tags, mode, limit, offset

  Search annotations by query, colors, or tags

  试试:Find all yellow highlights in my PDFs试试:Show me annotations tagged with 'important'
• search_fulltextq, itemKeys, mode, contextLength, caseSensitive

  Full-text search across all document content with context snippets

  试试:Find all mentions of 'cognitive dissonance' in my library试试:Search case-sensitive for 'DIAGNOSIS' in PDFs
• get_item_detailsitemKey, mode

  Get complete metadata for a single item

  试试:Show me all details for item ABC123试试:Get full metadata for this citation
• get_contentitemKey, attachmentKey, mode, include, contentControl, format

  Extract PDF full-text, notes, abstracts, webpage snapshots from items

  试试:Get the full text of this PDF试试:Show me all notes for this article
• get_collectionsmode, limit, offset

  Get all collections in the Zotero library

  试试:List all my collections试试:Show me first 10 collections
• get_collection_detailscollectionKey

  Get details of a specific collection

  试试:Show details for my 'Machine Learning' collection试试:What's in collection XYZ789?
• semantic_searchquery, topK, minScore, language

  AI-powered semantic search using embedding vectors

  试试:Find papers similar to about transformer architectures试试:Search conceptually for studies on attention mechanisms
• write_noteaction, parentKey, noteKey, content, tags

  Create or modify Zotero notes

  试试:Add a note to this paper about methodology试试:Update my existing note on this article
• write_tagaction, itemKey, tags

  Add, remove, or replace tags on items

  试试:Add tag 'important' to this paper试试:Remove tag 'toread' from this item
• write_metadataitemKey, fields, creators

  Update metadata fields on items

  试试:Change the title of this paper试试:Update the authors for this citation
• write_itemaction, itemType, fields, creators, tags, attachmentKeys, parentKey

  Create new items or reparent existing attachments

  试试:Create a new article entry试试:Move this PDF to be a child of this citation

可对比工具

安装

{
  "mcpServers": {
    "zotero": {
      "transport": "streamable_http",
      "url": "http://127.0.0.1:23120/mcp"
    }
  }
}

FAQ

支持哪些 AI 客户端？

该插件支持 Claude Desktop、Cherry Studio、Cursor IDE 以及任何实现了可流式 HTTP MCP 协议的客户端。

它是否支持离线使用？

是的，该插件仅本地运行，确保完全的数据隐私，无需与外部服务器通信。

如何启用语义搜索？

语义搜索使用来自 OpenAI 或 Ollama API 的嵌入向量。在 Zotero 首选项中配置您的 API 密钥，并通过集合/项目上下菜单重建索引。

zotero-mcp 对比