内容
# Zotero MCP 服务器
一款与 Zotero 本地 API 集成的 MCP(模型上下文协议)服务器,用于搜索、检索和提取 Zotero 库中 PDF 的全文。
## 前置条件
- 已启用本地 API 的 Zotero 应用程序
- uv(推荐)或 Python 3.12+ 及 pip
## 启用 Zotero 本地 API
在 Zotero 的设置中(首选项 → 高级 → 通用),启用:
✅ **允许此电脑上的其他应用程序与 Zotero 通信**
## 配置
将以下内容添加到您的 MCP 客户端配置文件中(例如,Antigravity 的 `mcp_config.json`,Claude Desktop 或 Cursor 的 `mcp.json`):
```json
{
"mcpServers": {
"zotero": {
"command": "uvx",
"args": ["git+https://github.com/yuogawaiic/zotero-mcp.git"]
}
}
}
```
## 可用工具
| 工具 | 参数 | 描述 |
|------|--------|---------|
| `zotero_search_items` | `q`(可选) | 按作者姓名或标题在您的 Zotero 库中搜索条目。返回最多 30 个匹配条目(不包括附件)。 |
| `zotero_get_item` | `itemKey`(必填) | 检索特定条目的详细信息,包括标题、作者、出版信息、摘要、标签等。 |
| `zotero_read_pdf` | `itemKey`(必填) | 从与 Zotero 条目关联的 PDF 附件中提取全文。 |
| `read_pdf` | `local_path`(必填) | 从本地文件路径的 PDF 文件中提取全文。可与文件系统 MCP 服务器一起使用。 |