Zotero MCP服务器(Ubuntu)
FastMCP服务器,为Claude Code提供了通过运行在Windows上的网桥服务器与Zotero交互的工具。
建筑```
Claude Code (Ubuntu VM)
│
└── Zotero MCP Server (this)
│
│ HTTP requests
▼
Windows Host (192.168.56.1:5555)
│
├── Zotero Bridge Server (Flask)
│ │
│ ▼
└── Zotero + Better BibTeX
## 设置
1. 创建虚拟环境:```bash
uv venv
source .venv/bin/activate
uv pip install fastmcp httpx
- 发现Windows主机IP:```bash
python discover_host.py
3. 配置Claude代码(添加到 `.mcp.json`):```json
{
"mcpServers": {
"zotero": {
"command": "/home/vboxuser/projects/zotero-mcp/run_zotero_mcp.sh",
"args": []
}
}
}
提供的工具
| 工具 | 说明 |
|---|---|
check_zotero_connection |
验证网桥连接 |
search_zotero |
搜索库,返回可扫描的引用 |
get_scannable_cite |
为citekey获取ODF可扫描引用 |
get_scannable_cites_batch |
获取多个可扫描的引用 |
get_item_metadata |
完整的CSL-JSON元数据 |
get_abstract |
快速标题+摘要查找 |
list_collections |
列出Zotero系列 |
get_collection_items |
获取收藏中的项目 |
generate_bibliography |
生成格式化的参考书目 |
可扫描引文格式
输出格式与Zotero ODF扫描插件匹配:{ | (Author et al., Year) | | |zu:LIBID:ITEMKEY}
文件
zotero_mcp.py-MCP服务器discover_host.py-网络发现脚本run_zotero_mcp.sh-Claude代码的包装脚本start_zotero_mcp.sh-手动启动脚本
