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设置
- 创建虚拟环境:
uv venv
source .venv/bin/activate
uv pip install fastmcp httpx- 发现Windows主机IP:
python discover_host.py- 配置Claude代码(添加到
.mcp.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-手动启动脚本
