Zotero

🚀 Zotero MCP 连接器

这是一款模型控制协议（MCP）连接器，它的主要作用是将本地 Zotero 与 Claude 进行集成。借助该连接器，您能够直接通过 Claude 的桌面界面访问本地的 Zotero 图书馆。不过，此连接器依赖于 Zotero 7 中本地 Web API 的支持。

本项目受到了使用 Node.js 和 Web API 的 mcp - zotero 仓库的启发，并且是基于出色的 pyzotero 库构建而成。

🚀 快速开始

本连接器可让您在 Claude 桌面界面便捷访问本地 Zotero 图书馆，下面为您介绍具体操作。

✨ 主要特性

• 实现本地 Zotero 与 Claude 的集成，可通过 Claude 桌面界面访问 Zotero 图书馆。
• 提供多种功能，如列出集合、获取集合项目、查看论文详情、搜索图书馆以及获取最近添加的论文等。

📦 安装指南

有关 Claude Desktop 如何与 MCP 交互的信息，请参阅 here。

1. 使用 uv。安装说明请访问 here。
2. 将项目克隆到本地并激活虚拟环境：

git clone https://github.com/gyger/mcp-pyzotero.git
cd mcp-pyzotero
uv sync

3. 在 Zotero 7 中启用本地 API：
4. 将服务器添加到您的本地 Claude 安装中：

uv run mcp install zotero.py

💻 使用示例

基础用法

连接器提供了一系列实用功能，以下为您展示部分基础功能的使用方法。

# 列出您的 Zotero 图书馆中的所有集合
get_collections()

# 获取特定集合中的所有项目
collection_key = "your_collection_key"
get_collection_items(collection_key)

# 获取特定论文的详细信息，包括摘要
item_key = "your_item_key"
get_item_details(item_key)

# 搜索整个 Zotero 图书馆
query = "your_search_query"
search_library(query)

# 获取最近添加到图书馆的论文
get_recent(limit=10)

📚 详细文档

配置

连接器配置为与本地 Zotero 安装一起使用，目前仅支持 user 图书馆。默认情况下，它使用用户 ID 0，但您也可以通过设置环境变量 ZOTERO_USER_ID 来指定：

uv run mcp install zotero.py -v ZOTERO_USER_ID=0

可用功能

连接器提供以下功能：

• get_collections(): 列出您的 Zotero 图书馆中的所有集合
• get_collection_items(collection_key): 获取特定集合中的所有项目
• get_item_details(item_key): 获取特定论文的详细信息，包括摘要
• search_library(query): 搜索整个 Zotero 图书馆
• get_recent(limit=10): 获取最近添加到图书馆的论文

未来计划扩展此功能。

要求

• Python 3.10+
• 本地 Zotero 安装
• Claude Desktop

贡献

欢迎贡献！请访问 GitHub 仓库：

• 报告问题
• 提交拉取请求
• 建议改进

📄 许可证

本项目采用 MIT 许可证。