AI导哈

Zotero MCP服务

一个支持读写操作的MCP服务器，用于通过AI助手管理Zotero库，包括创建项目、管理集合、查找合并重复项以及导入BibTeX。

  • by BirdInTheTree
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 BirdInTheTree/zotero-mcp

使用说明

佐特罗mcp

Zotero的读写MCP服务器。MCP服务器 完全写入支持 用于通过AI助手管理Zotero库。

它允许您创建项目、管理集合、查找和合并重复项，以及从克劳德代码/桌面或任何兼容MCP的客户端导入BibTeX。

使用 Zotero Web API （需要API密钥）。把钥匙拿到https://www.zotero.org/settings/keys.

特性

搜索和阅读

工具 说明
search_items 使用集合、类型和标签过滤器进行全文搜索
get_item 单个项目的详细元数据或BibTeX导出
get_collections 列出所有具有层次结构和项目计数的集合
get_collection_items 列出特定集合中的项目
find_duplicates 按标题/DOI查找重复项，或扫描整个库
get_tags 列出所有带有项目计数的标签

写

工具 说明
create_item 从字段数据创建项目
create_item_from_doi 按DOI创建项目（通过Zotero翻译器+CrossRef自动填充元数据）
import_bibtex 将BibTeX条目导入集合
update_item 使用版本冲突保护更新项目字段

集合

工具 说明
create_collection 创建一个集合（带可选父项）
add_to_collections 一次将一个项目添加到多个集合中
remove_from_collection 从集合中删除项目（不删除它）

管理

工具 说明
merge_duplicates 合并重复项：将元数据、标签、集合转移到保管器，删除其余内容
delete_item 删除项目

安装

需要Python 3.11+和 紫外线.

# Clone the repo
git clone https://github.com/BirdInTheTree/zotero-mcp.git
cd zotero-mcp
uv sync

用法

克劳德代码

claude mcp add zotero \
  -e ZOTERO_API_KEY=your-key \
  -e ZOTERO_USER_ID=your-user-id \
  -- uv run --directory /path/to/zotero-mcp python -m zotero_mcp

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "zotero": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/zotero-mcp", "python", "-m", "zotero_mcp"],
      "env": {
        "ZOTERO_API_KEY": "your-key",
        "ZOTERO_USER_ID": "your-user-id"
      }
    }
  }
}

配置

变量 必填 描述
ZOTERO_API_KEY yes Zotero Web API密钥
ZOTERO_USER_ID 是 您的Zotero用户ID

获取API密钥：https://www.zotero.org/settings/keys.您的用户ID显示在同一页面上。

示例

连接后，您可以向您的AI助手询问以下问题：

  • “在我的Zotero中搜索文件…”
  • “创建一个名为…的新集合”
  • “将此BibTeX导入我的收藏”
  • “在我的库中查找重复项并合并它们”
  • “将此论文添加到两个收藏中”
  • “查找DOI 10.1234/example.并将其添加到我的库中”

发展

# Install with dev dependencies
uv sync --dev

# Run tests
uv run pytest tests/ -v

许可证

麻省理工学院

相关 MCP