mcp-server-zotero-dev

Zotero プラグイン開発用 MCP サーバー

AI アシスタントが Zotero 7+ プラグインを構築、テスト、デバッグできるようにする MCP（Model Context Protocol） サーバーです。UI の調査、JavaScript の実行、ビルド連携、ログ、データベースへのアクセス、プラグイン管理を行う 25 個のツールを提供します。

仕組み：Zotero 7+ は Firefox ESR をベースとしているため、このサーバーは Firefox に組み込まれた Remote Debugging Protocol（RDP）を介して Zotero と通信します。コンパニオンプラグインの MCP Bridge for Zotero が Zotero 内で DevTools サーバーを起動し、この MCP サーバーが接続します。

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

前提条件

• Node.js >= 20
• Zotero 7+（リリース版、ベータ版、または開発版）
• Zotero に MCP Bridge for Zotero プラグインがインストールされていること — 最新の XPI をダウンロード

MCP Bridge プラグインのインストール

1. GitHub Releases から zotero-mcp-bridge-*.xpi をダウンロードします
2. Zotero で、ツール > アドオン > 歯車アイコン > ファイルからアドオンをインストール... を選択します
3. ダウンロードした .xpi ファイルを選択します
4. Zotero を再起動します

プラグインは Zotero の起動時に、ポート 6100 で DevTools サーバーを自動的に起動します。

セットアップ

Claude Desktop

claude_desktop_config.json に追加します。

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

Claude Code

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

Cursor / Windsurf / その他の MCP クライアント

次の設定で MCP サーバーを構成します。

• コマンド：npx
• 引数：-y @introfini/mcp-server-zotero-dev

または、グローバルにインストールします。

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

ツール（25）

JavaScript の実行と調査

Tool	Description
zotero_ping	Zotero への接続をテストし、バージョン情報を取得します
zotero_execute_js	Zotero の特権付き chrome コンテキストで JavaScript を実行します
zotero_get_pref	Zotero の設定値を取得します
zotero_set_pref	Zotero の設定値を設定します
zotero_search_prefs	Zotero / Firefox の設定を検索して一覧表示します
zotero_inspect_object	JavaScript オブジェクトを調査し、メソッドとプロパティを確認します
zotero_open_preferences	Zotero の設定ウィンドウを開き、必要に応じてペインに移動します

UI の調査

Tool	Description
zotero_screenshot	Zotero のスクリーンショットを撮影します（メインウィンドウ、特定のウィンドウ、または要素）
zotero_inspect_element	CSS セレクターで DOM 要素を検索します
zotero_get_dom_tree	簡略化した DOM ツリー構造を取得します
zotero_get_styles	要素の計算済み CSS スタイルを取得します
zotero_list_windows	開いている Zotero ウィンドウをすべて一覧表示します

ログとデバッグ

Tool	Description
zotero_read_logs	Zotero のデバッグログ出力を読み取ります
zotero_read_errors	Zotero のエラーコンソールからエラーを読み取ります
zotero_clear_logs	デバッグログバッファーとエラーコンソールをクリアします
zotero_watch_logs	新しいログメッセージの監視を開始／停止します

ビルド連携

Tool	Description
zotero_scaffold_build	zotero-plugin-scaffold を使用して Zotero プラグインをビルドします
zotero_scaffold_serve	ホットリロード対応の開発サーバーを起動／停止します
zotero_scaffold_lint	プラグインプロジェクトで ESLint を実行します
zotero_scaffold_typecheck	TypeScript の型チェックを実行します

プラグイン管理

Tool	Description
zotero_plugin_reload	Zotero プラグインを再読み込みします
zotero_plugin_list	インストール済みのプラグインをすべて一覧表示します
zotero_plugin_install	ローカルの XPI ファイルからプラグインをインストールします

データベースへのアクセス（読み取り専用）

Tool	Description
zotero_db_query	Zotero のデータベースに対して SELECT クエリを実行します
zotero_db_schema	データベースのスキーマ情報を取得します
zotero_db_stats	データベースの統計情報を取得します

プロンプト（5）

プロンプト	説明
setup-dev	Zotero プラグインの開発環境を一からセットアップします
debug-plugin	Zotero に接続して、プラグインのデバッグを開始します
fix-errors	Zotero のエラーコンソールからエラーを見つけて修正します
inspect-api	Zotero の JavaScript API を対話形式で調べます
migrate-z7	Zotero 6 から Zotero 7 へのプラグインの移行を支援します

設定

環境変数（すべて省略可能）：

変数	デフォルト値	説明
ZOTERO_RDP_PORT	6100	接続先の RDP ポート
ZOTERO_RDP_HOST	localhost	RDP ホストアドレス
ZOTERO_DATA_DIR	自動検出	Zotero データディレクトリのパス
ZOTERO_PROFILE_PATH	自動検出	Zotero プロファイルのパス

トラブルシューティング

「Zotero に接続できません」

1. Zotero が実行中であることを確認します
2. MCP Bridge プラグインがインストールされていることを確認します（ツール > アドオン）
3. プラグインのインストール後、Zotero を再起動します
4. ポート 6100 がブロックされていないことを確認します：lsof -i :6100

「ポートはすでに使用されています」

• 別の Zotero インスタンスが実行中か、Zotero が -debugger フラグで起動されています（ポート 6000 を使用します）。MCP Bridge は競合を避けるため、ポート 6100 を使用します。

ライセンス

MIT