🚀 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。
- 使用
uv。安装说明请访问 here。 - 将项目克隆到本地并激活虚拟环境：
git clone https://github.com/gyger/mcp-pyzotero.git
cd mcp-pyzotero
uv sync
- 在 Zotero 7 中启用本地 API：
- 将服务器添加到您的本地 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 许可证。