@xbghc/zotero-mcp

Zotero MCP Server - 通过 MCP 协议管理 Zotero 文献库。

功能

• 查询文献: 搜索、获取详情、获取全文、按分组/标签过滤
• 创建文献: 手动创建或通过 DOI/ISBN/PMID 自动获取元数据
• 管理文献: 更新、删除、添加标签、添加到分组、下载附件
• 导出引用: 支持 BibTeX、RIS、CSL JSON 等格式

快速开始

1. 获取 Zotero API Key

1. 登录 zotero.org
2. 进入 Settings → Security
3. 记下你的 User ID
4. 点击 "Create new private key" 生成 API Key

2. 配置 Claude Code

在 ~/.claude/settings.json 中添加：

{
  "mcpServers": {
    "zotero": {
      "command": "npx",
      "args": ["@xbghc/zotero-mcp"],
      "env": {
        "ZOTERO_API_KEY": "your-api-key",
        "ZOTERO_USER_ID": "your-user-id"
      }
    }
  }
}

配置完成后重启 Claude Code 即可使用。

可选配置

Translation Server（DOI 自动获取）

create_item_by_identifier 工具需要 Translation Server 支持。

git clone --recurse-submodules https://github.com/zotero/translation-server.git
cd translation-server
npm install
npm start

服务运行在 http://localhost:1969，然后在 env 中添加：

"TRANSLATION_SERVER_URL": "http://localhost:1969"

环境变量

变量	必需	说明
ZOTERO_API_KEY	是	Zotero API 密钥
ZOTERO_USER_ID	是	用户 ID
ZOTERO_GROUP_ID	否	群组 ID（访问群组库时使用）
TRANSLATION_SERVER_URL	否	Translation Server 地址
ZOTERO_MCP_CACHE_DIR	否	附件缓存目录

开发

npm install
npm run build
npm test

License

MIT