README

@xbghc/zotero-mcp

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

功能

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

快速开始

1. 获取 Zotero API Key

登录 zotero.org
进入 Settings → Security
记下你的 User ID
点击 "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

@xbghc/zotero-mcp

README

@xbghc/zotero-mcp

功能

快速开始

1. 获取 Zotero API Key

2. 配置 Claude Code

可选配置

Translation Server（DOI 自动获取）

环境变量

开发

License

Recommended Servers