MCP工具

Prerequisites

• Node.js 20+ and npm
• Zotero 7+ — Works on all Zotero 7, 8, and 9 builds (release, beta, dev)
• For plugin development: zotero-plugin-scaffold

1. Install MCP Server

Use install-mcp to add the server to your AI assistant:

npx -y install-mcp @introfini/mcp-server-zotero-dev --client claude-code

Supported clients: claude-code, cursor, windsurf, vscode, cline, roo-cline, claude, zed, goose, warp, codex

<details> <summary><strong>Claude Code</strong></summary>

npx -y install-mcp @introfini/mcp-server-zotero-dev --client claude-code

<details> <summary><strong>Cursor</strong></summary>

npx -y install-mcp @introfini/mcp-server-zotero-dev --client cursor

<details> <summary><strong>VS Code / Copilot</strong></summary>

npx -y install-mcp @introfini/mcp-server-zotero-dev --client vscode

<details> <summary><strong>Windsurf</strong></summary>

npx -y install-mcp @introfini/mcp-server-zotero-dev --client windsurf

<details> <summary><strong>Manual Configuration</strong></summary>

Add to your MCP client config:

{
  "mcpServers": {
    "zotero-dev": {
      "command": "npx",
      "args": ["-y", "@introfini/mcp-server-zotero-dev"],
      "env": {
        "ZOTERO_RDP_PORT": "6100"
      }
    }
  }
}

Restart your AI assistant after adding the configuration.

2. Install MCP Bridge Plugin in Zotero

Download zotero-mcp-bridge.xpi and install:

1. In Zotero: Tools → Plugins
2. Click ⚙️ → Install Plugin From File
3. Select the downloaded .xpi file
4. Restart Zotero

This lightweight plugin enables the Remote Debugging Protocol when Zotero starts. It only needs to be installed once and works on all Zotero 7+ builds (release, beta, and dev).

Clone and install

git clone https://github.com/introfini/mcp-server-zotero-dev.git cd mcp-server-zotero-dev npm install

Build everything

npm run build

Build individual packages

npm run build -w mcp-server npm run build -w zotero-plugin-mcp-rdp

🚀 Quick Start

📸 Screenshot Examples

// Capture main Zotero window
await zotero_screenshot({ target: 'main-window' });

// Capture your plugin's panel with highlight
await zotero_screenshot({
  target: 'element',
  selector: '#my-plugin-panel',
  highlightSelector: '#my-plugin-button'
});

// Capture a specific window by ID (use zotero_list_windows to find IDs)
await zotero_screenshot({
  target: 'window',
  windowId: 12345
});

// Capture element after triggering UI action
await zotero_execute_js({ code: 'document.querySelector("#menu").click()' });
await zotero_screenshot({ target: 'element', selector: 'menupopup[state="open"]' });

---

🔧 Environment Variables

---