Zotero MCP Connector

Zotero MCP连接器

\[！重要\]\ 该项目已退役。我不再相信MCP是一个想要的接口，最好有直接的CLI访问。 如果你喜欢MCP，有几个选项，但我没有测试它们。 - 佐特罗mcp - zotero mcp服务器 - 麦克普·佐特罗

用于将本地Zotero与Claude集成的模型控制协议（MCP）连接器。\ 这使得您可以通过Claude的桌面界面直接读取本地Zotero库。 这取决于在Zotero 7中访问本地web api的能力。

这是受到使用Node.js和web api的存储库的启发： 麦克普·佐特罗.\ 这建立在梦幻般的肩膀上 皮佐特罗 图书馆。

安装

从本地代码运行（推荐）

有关Claude Desktop与MCP交互的信息，请参阅 这里.

1. 使用 uv.可以找到安装说明 这里.

1. 将git项目签入本地空间并激活其中的虚拟环境：

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

1. 在Zotero 7中启用本地API：

Zotero Local API Settings

1. 将服务器添加到本地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库，有两种可能的模式：一切或标题创作者年份。

将来应该扩展此功能。

需求

• Python 3.10+

- 皮佐特罗 - mcp\[cli\]

• 本地Zotero安装

贡献

欢迎投稿！请访问 致：

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

许可证

麻省理工学院