hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Provides access to your Zotero library, allowing you to search for items, retrieve detailed metadata, and access the full text contents of PDFs and other documents stored in your Zotero collection.
Zotero 的模型上下文协议服务器
该项目是一个 Python 服务器，它实现了Zotero的模型上下文协议 (MCP) ，使您可以在 AI 助手中访问 Zotero 库。它旨在实现一组规模虽小但极其实用的 Zotero 交互，以便与MCP 客户端配合使用。
特征
该 MCP 服务器提供以下工具：
zotero_search_items：使用文本查询在 Zotero 库中搜索项目zotero_item_metadata：获取有关特定 Zotero 项目的详细元数据信息zotero_item_fulltext：获取特定 Zotero 项目的全文（即 PDF 内容）
这些可以通过任何 MCP 客户端或MCP 检查器发现和访问。
每个工具都会返回包含 Zotero 项目相关信息的格式化文本，而 Claude 等 AI 助手可以按顺序使用它们，搜索项目，然后检索其元数据或文本内容。
安装
要将其与 Claude Desktop 一起使用，请将以下内容添加到mcpServers配置中：
ZOTERO_LOCAL设置将插件指向本地 Zotero API ，并要求 Zotero 7（或测试版，请参阅下面的注释）与客户端在同一台机器上运行。
要使用 Zotero Web 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 Beta 版本才能使用此功能（截至 2025 年 3 月 7 日）。更多信息请参阅https://github.com/zotero/zotero/pull/5004 。
发展
- 克隆此存储库
- 通过运行以下命令安装uv依赖项：
uv sync - 使用上述环境变量在项目根目录中创建一个
.env文件
启动MCP Inspector进行本地开发：
运行测试
运行测试套件：
相关文件
You must be authenticated.
该服务器允许用户通过模型上下文协议与他们的 Zotero 库进行交互，提供搜索项目、检索元数据和使用自然语言查询访问全文的工具。