MCP Zotero
用于Zotero集成的模型上下文协议服务器,允许Claude与您的Zotero库进行交互。
设置
- 获取您的Zotero证书:```bash
First, create an API key at https://www.zotero.org/settings/keys
Then use it to get your user ID:
curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/current
响应如下:```json
{
"userID": 123456,
"username": "your_username",
"access": {
"user": {
"library": true,
"files": true,
"notes": true,
"write": true
}
}
}
这 userID 价值就是你需要的。
- 设置环境变量:```bash
export ZOTERO_API_KEY="your-api-key"
export ZOTERO_USER_ID="user-id-from-curl"
1. 验证您的凭据:```bash
# Test that your credentials work:
curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
"https://api.zotero.org/users/$ZOTERO_USER_ID/collections"
您应该在回复中看到您的收藏列表。
- 安装并运行:```bash
Install globally (recommended)
npm install -g mcp-zotero
mcp-zotero
Or run directly with npx
npx mcp-zotero
## 与Claude Desktop集成
要将此服务器与Claude Desktop一起使用,请将以下内容添加到您的Claude Desktop配置中:```json
{
"mcpServers": {
"zotero": {
"command": "mcp-zotero",
"env": {
"ZOTERO_API_KEY": YOUR_API_KEY,
"ZOTERO_USER_ID": YOUR_USER_ID
}
}
}
}
可用工具
get_collections:列出您图书馆的所有馆藏get_collection_items:获取特定收藏中的物品get_item_details:获取有关论文的详细信息search_library:搜索整个图书馆get_recent:获取最近添加的论文
故障排除
如果您遇到任何问题:
- 验证您的环境变量是否已设置:```bash
echo $ZOTERO_API_KEY
echo $ZOTERO_USER_ID
1. 检查安装情况:```bash
npm list -g mcp-zotero
- 尝试重新安装:
bash npm uninstall -g mcp-zotero npm install -g mcp-zotero
