Mcp Server Zotero Dev

io.github.introfini由 GitHub 帳號 introfini 發布v1.1.4更新於 Oct 24, 2026

MCP server enabling AI assistants to build, test, and debug Zotero plugins

已驗證STDIO僅桌面資料庫瀏覽器自動化開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器，讓 AI 助理透過 Firefox 遠端偵錯協定操控執行中的 Zotero，以建置、測試與偵錯 Zotero 7+ 外掛。

可以做什麼
  • 連線 Zotero，在其特權環境中執行 JavaScript，讀取與設定偏好設定，檢視物件並開啟偏好設定視窗
  • 檢視介面：擷取畫面、依 CSS 選擇器尋找 DOM 元素、讀取 DOM 樹與計算樣式、列出已開啟視窗
  • 讀取、監看與清除 Zotero 偵錯記錄與錯誤主控台訊息
  • 使用 zotero-plugin-scaffold 建置外掛、啟動熱重載開發伺服器、執行 ESLint 與 TypeScript 型別檢查
  • 列出外掛、從本機 XPI 安裝外掛並重新載入外掛
  • 對 Zotero 資料庫執行唯讀 SELECT 查詢，檢視結構與統計資訊
適用情境
適合在開發或維護 Zotero 7+ 外掛時使用，讓助理直接檢視執行中的 Zotero 介面、執行程式碼、讀取記錄與錯誤，並完成建置與重新載入步驟，不必切換工具。
執行需求
透過 npx 或全域 npm 安裝後在本機執行；需要 Node.js 20 以上版本、執行中的 Zotero 7+，以及另外安裝的 MCP Bridge for Zotero 外掛，讓 DevTools 服務監聽 6100 埠。選用環境變數 ZOTERO_RDP_HOST、ZOTERO_RDP_PORT、ZOTERO_DATA_DIR 與 ZOTERO_PROFILE_PATH 可覆寫預設值。
安裝前請注意
助理可在 Zotero 的特權 chrome 環境中執行任意 JavaScript、修改偏好設定、從 XPI 檔案安裝外掛並清除記錄，因此操作會影響實際的 Zotero 設定與文獻庫。資料庫存取描述為唯讀 SELECT 查詢。RDP 埠預設沒有身分驗證，應只綁定本機。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Server Zotero Dev，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

MCP Server for Zotero Plugin Development

An MCP (Model Context Protocol) server that enables AI assistants to build, test, and debug Zotero 7+ plugins. It provides 25 tools for UI inspection, JavaScript execution, build integration, logging, database access, and plugin management.

How it works: Zotero 7+ is built on Firefox ESR, so this server communicates with Zotero through Firefox's built-in Remote Debugging Protocol (RDP). A small companion plugin (MCP Bridge for Zotero) starts the DevTools server inside Zotero, and this MCP server connects to it.

AI Assistant (Claude, Cursor, Windsurf, etc.)         | MCP Protocol (stdio)         v    MCP Server (this package)         | Firefox RDP (TCP port 6100)         v    Zotero + MCP Bridge Plugin

Prerequisites

  • Node.js >= 20
  • Zotero 7+ (release, beta, or dev build)
  • MCP Bridge for Zotero plugin installed in Zotero — download the latest XPI

Installing the MCP Bridge plugin

  1. Download zotero-mcp-bridge-*.xpi from GitHub Releases
  2. In Zotero: Tools > Add-ons > gear icon > Install Add-on From File...
  3. Select the downloaded .xpi file
  4. Restart Zotero

The plugin automatically starts a DevTools server on port 6100 when Zotero launches.

Setup

Claude Desktop

Add to your claude_desktop_config.json:

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

Claude Code

bash
claude mcp add zotero-dev -- npx -y @introfini/mcp-server-zotero-dev

Cursor / Windsurf / Other MCP clients

Configure the MCP server with:

  • Command: npx
  • Arguments: -y @introfini/mcp-server-zotero-dev

Or install globally:

bash
npm install -g @introfini/mcp-server-zotero-dev

Tools (25)

JavaScript Execution & Inspection

ToolDescription
zotero_pingTest connection to Zotero and get version info
zotero_execute_jsExecute JavaScript in Zotero's privileged chrome context
zotero_get_prefGet a Zotero preference value
zotero_set_prefSet a Zotero preference value
zotero_search_prefsSearch and list Zotero/Firefox preferences
zotero_inspect_objectInspect a JavaScript object to discover methods and properties
zotero_open_preferencesOpen Zotero's preferences window, optionally navigating to a pane

UI Inspection

ToolDescription
zotero_screenshotCapture a screenshot of Zotero (main window, specific window, or element)
zotero_inspect_elementFind DOM elements by CSS selector
zotero_get_dom_treeGet a simplified DOM tree structure
zotero_get_stylesGet computed CSS styles for an element
zotero_list_windowsList all open Zotero windows

Logging & Debugging

ToolDescription
zotero_read_logsRead Zotero's debug log output
zotero_read_errorsRead errors from Zotero's error console
zotero_clear_logsClear the debug log buffer and error console
zotero_watch_logsStart/stop watching for new log messages

Build Integration

ToolDescription
zotero_scaffold_buildBuild a Zotero plugin using zotero-plugin-scaffold
zotero_scaffold_serveStart/stop the dev server with hot reload
zotero_scaffold_lintRun ESLint on a plugin project
zotero_scaffold_typecheckRun TypeScript type checking

Plugin Management

ToolDescription
zotero_plugin_reloadReload a Zotero plugin
zotero_plugin_listList all installed plugins
zotero_plugin_installInstall a plugin from a local XPI file

Database Access (Read-only)

ToolDescription
zotero_db_queryExecute a SELECT query on Zotero's database
zotero_db_schemaGet database schema information
zotero_db_statsGet database statistics

Prompts (5)

PromptDescription
setup-devSet up Zotero plugin development environment from scratch
debug-pluginConnect to Zotero and start debugging your plugin
fix-errorsFind and fix errors from Zotero's error console
inspect-apiInteractive exploration of Zotero's JavaScript APIs
migrate-z7Help migrate a plugin from Zotero 6 to Zotero 7

Configuration

Environment variables (all optional):

VariableDefaultDescription
ZOTERO_RDP_PORT6100RDP port to connect to
ZOTERO_RDP_HOSTlocalhostRDP host address
ZOTERO_DATA_DIRauto-detectedZotero data directory path
ZOTERO_PROFILE_PATHauto-detectedZotero profile path

Troubleshooting

"Cannot connect to Zotero"

  1. Make sure Zotero is running
  2. Verify the MCP Bridge plugin is installed (Tools > Add-ons)
  3. Restart Zotero after installing the plugin
  4. Check port 6100 is not blocked: lsof -i :6100

"Port already in use"

  • Another Zotero instance may be running, or Zotero was started with the -debugger flag (which uses port 6000). The MCP Bridge uses port 6100 to avoid conflicts.

License

MIT

來源：packages/mcp-server/README.md，提交 24f8f50

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

2
  1. v1.1.4最新Sep 20, 2026
  2. v1.1.3Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分