AI导哈

Zotero桥接服务器

一个FastMCP服务器，为Claude Code提供通过Windows主机上的桥接服务器与Zotero交互的工具。

  • by jwingnut
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 jwingnut/zotero-mcp-ubuntu

使用说明

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. 创建虚拟环境：
uv venv
source .venv/bin/activate
uv pip install fastmcp httpx
  1. 发现Windows主机IP：
python discover_host.py
  1. 配置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 -手动启动脚本

相关 MCP