Zotero MCP 连接器

[!IMPORTANT]
该项目已退役。我不再认为MCP是理想的接口，建议直接使用CLI访问。 如果你喜欢MCP，有几个选项，但我没有测试它们。

• zotero-mcp
• zotero-mcp-server
• mcp-zotero

这是一个用于将本地Zotero与Claude集成的模型控制协议（MCP）连接器。 这使得可以通过Claude的桌面界面直接读取访问您的本地Zotero库。 它依赖于能够访问Zotero 7中的本地web-api。

这个项目受到了一个使用Node.js和web api的仓库的启发：mcp-zotero。 此项目基于出色的pyzotero库进行构建。

安装

从本地代码运行（推荐）

有关Claude Desktop与MCP交互的信息，请参阅此处。

1. 使用uv。安装说明请参阅这里。

2. 将git项目检出到本地空间并激活内部虚拟环境：

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

使用uvx封装运行（应能工作）

编辑您的Claude Desktop软件配置文件。

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

并添加Zotero条目

{
    "mcpServers": {
        "Zotero": {
            "command": "uvx",
            "args": ["--from", "git+https://github.com/gyger/mcp-pyzotero.git", 
                     "--with", "mcp[cli]",
                     "--with", "pyzotero",
                     "mcp", "run", "zotero.py"
                    ],
        }
    }
}

配置

该连接器配置为与本地Zotero安装一起工作，并且目前仅支持user库。 默认情况下，它使用用户ID 0，但如果您需要，也可以设置环境变量ZOTERO_USER_ID：

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

可用功能

可用工具

• get_zotero_summary(): 列出关于您库的属性，包括集合、最近项目或标签。
• get_collection_items(collection_key): 获取特定集合中的所有项目
• get_items_metadata(item_key): 获取特定论文的详细信息，包括摘要。
• search_library(query, mode): 搜索您的Zotero库，有两种可能模式：everything或titleCreatorYear。

此功能应在未来得到扩展。

要求

• Python 3.10+
  • pyzotero
  • mcp[cli]
• 本地Zotero安装

贡献

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

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

许可证

MIT