Zotero MCP 连接器

一个用于将本地Zotero与Claude集成的模型控制协议(MCP)连接器,支持通过Claude桌面界面直接读取本地Zotero库。

  • by gyger
  • Python
  • 本地部署
  • 56 星标
  • 更新于
在 GitHub 查看 gyger/mcp-pyzotero

使用说明

Zotero MCP连接器

[!重要]
该项目已退役。我不再相信MCP是一个想要的接口,最好有直接的CLI访问。 如果你喜欢MCP,有几个选项,但我没有测试它们。

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

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

安装

从本地代码运行(推荐)

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

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

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

git clone https://github.com/gyger/mcp-pyzotero.git
cd mcp-pyzotero
uv sync
  1. 在Zotero 7中启用本地API:

  2. 将服务器添加到本地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安装

贡献

欢迎投稿!请访问 GitHub存储库 致:

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

许可证

麻省理工学院