io.github.introfini/mcp-server-zotero-dev
NPM · @INTROFINI/MCP-SERVER-ZOTERO-DEV · SCANNED AUG 4
MCP server enabling AI assistants to build, test, and debug Zotero plugins
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security86
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 39 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability85
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 2484 tokens (~88/item across 28 items; 28 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management30
- Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @introfini/mcp-server-zotero-dev
claude mcp add introfini-mcp-server-zotero-dev -- npx -y @introfini/mcp-server-zotero-dev
codex mcp add introfini-mcp-server-zotero-dev -- npx -y @introfini/mcp-server-zotero-dev
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"introfini-mcp-server-zotero-dev": {
"type": "local",
"command": [
"npx",
"-y",
"@introfini/mcp-server-zotero-dev"
],
"enabled": true
}
}
} openclaw mcp add introfini-mcp-server-zotero-dev --command npx --arg -y --arg @introfini/mcp-server-zotero-dev
mcp_servers:
introfini-mcp-server-zotero-dev:
command: "npx"
args: ["-y", "@introfini/mcp-server-zotero-dev"] {
"mcpServers": {
"introfini-mcp-server-zotero-dev": {
"command": "npx",
"args": [
"-y",
"@introfini/mcp-server-zotero-dev"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 4 Aug 26 +4
- Stability: unverified → 0.30 ▲ functional
- 2 Aug 26 +62
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Security disclosure: fail → unverified ▼ functional
- Schema quality: unverified → excellent ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → 100 ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Licence: MIT functional
- 31 Jul 26 −1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −47
- Malware scan: pass → unverified ▼ security
- Schema quality: 100 → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- 27 Jul 26 53
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 4 Aug 2026 · Analysed npm/@introfini/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 94 packages
94 packages in the resolved dependency tree · 94 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
zotero_clear_logs ~19
Clear the debug log buffer and error console.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
zotero_click_element ~260
Click an element in a Zotero window by CSS selector (toolbar/menu button, preference control, list row, etc.). Resolves light DOM first, then pierces open shadow roots (Zotero's XUL custom elements keep internals in shadow DOM). If the selector matches several elements, use index to pick one. By default calls element.click() (which fires the XUL command for buttons/menuitems); set mouseEvents=true to dispatch a synthesized mousedown/mouseup/click sequence for content that needs real mouse events. Cannot dismiss a BLOCKING native modal dialog (Services.prompt.confirmEx) — see the module note.
| Name | Type | Req | Description |
|---|---|---|---|
| index | number | — | Which match to click when the selector matches several (0-based, default 0) |
| mouseEvents | boolean | — | Dispatch synthesized mousedown/mouseup/click instead of element.click() (default false). Use for HTML content that needs real mouse events. Note: these events are untrusted (isTrusted=false); some na… |
| selector | string | yes | CSS selector for the element to click |
| windowId | number | — | Window outerWindowID (optional, defaults to main window) |
No output schema declared.
No examples provided.
zotero_db_query ~92
Execute a SELECT query on Zotero's database. Only SELECT queries are allowed for safety. Note: Database may be locked if Zotero is running - a copy may be used.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Maximum rows to return (default: 100, max: 1000) |
| params | array | — | Query parameters for prepared statements |
| query | string | yes | SQL SELECT query to execute |
No output schema declared.
No examples provided.
zotero_db_schema ~48
Get database schema information. If table is specified, returns columns for that table. Otherwise returns list of all tables.
| Name | Type | Req | Description |
|---|---|---|---|
| table | string | — | Table name to get schema for (optional) |
No output schema declared.
No examples provided.
zotero_db_stats ~22
Get database statistics: item counts, file size, etc.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
zotero_execute_js ~219
Execute JavaScript code in Zotero's privileged chrome context. Has full access to Zotero APIs (Zotero.*, ZoteroPane, etc.). Use for testing code snippets, inspecting state, or performing actions. Prefer a dedicated tool when one fits the question (zotero_db_query for library data, zotero_read_logs/zotero_read_errors for output, zotero_inspect_object for API discovery); reach for raw JS only when none does. Code with top-level 'return' statements is auto-wrapped in an IIFE. Tip: For complex objects, use JSON.stringify(obj) to get full data. IMPORTANT: Before calling unknown APIs, use zotero_inspect_object to discover available methods - don't guess API names.
| Name | Type | Req | Description |
|---|---|---|---|
| awaitPromise | boolean | — | Whether to await the result if it's a Promise (default: true) |
| code | string | yes | JavaScript code to execute. Can be async (automatically awaited). You can use 'return' at top level - code will be auto-wrapped in IIFE. |
No output schema declared.
No examples provided.
zotero_get_dom_tree ~85
Get a simplified DOM tree structure. Shows tag names, IDs, classes, and child counts for navigation.
| Name | Type | Req | Description |
|---|---|---|---|
| depth | number | — | Maximum depth to traverse (default: 3) |
| selector | string | — | CSS selector for root element (default: document.documentElement) |
| windowId | number | — | Window outerWindowID (optional, defaults to main window) |
No output schema declared.
No examples provided.
zotero_get_pref ~49
Get a Zotero preference value. Common prefs: extensions.zotero.*, general.*, export.*
| Name | Type | Req | Description |
|---|---|---|---|
| key | string | yes | Preference key (e.g., 'extensions.zotero.debug.log') |
No output schema declared.
No examples provided.
zotero_get_styles ~70
Get computed CSS styles for an element. Useful for debugging layout and styling issues.
| Name | Type | Req | Description |
|---|---|---|---|
| properties | array | — | Specific CSS properties to return (default: common layout properties) |
| selector | string | yes | CSS selector for the element |
| windowId | number | — | Window outerWindowID (optional) |
No output schema declared.
No examples provided.
zotero_inspect_element ~92
Find DOM elements by CSS selector and return their details. Returns: tagName, id, className, attributes, text content, bounding rect, child count.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Maximum number of elements to return (default: 10) |
| selector | string | yes | CSS selector to find elements |
| windowId | number | — | Window outerWindowID (optional, defaults to main window) |
No output schema declared.
No examples provided.
zotero_inspect_object ~174
Inspect a Zotero/JavaScript object to discover its methods and properties. Use to explore APIs like Zotero.Items, ZoteroPane, Zotero.Prefs without manual JS execution. Returns methods with signatures and properties with their types/values.
| Name | Type | Req | Description |
|---|---|---|---|
| depth | number | — | Prototype chain depth to inspect (default: 2, max: 5) |
| filter | string | — | What to include: 'all' (default), 'methods' only, 'properties' only, or 'own' (only own properties, not inherited) |
| path | string | yes | Object path to inspect (e.g., 'Zotero', 'Zotero.Items', 'ZoteroPane', 'Zotero.Prefs') |
| pattern | string | — | Filter member names by substring (case-insensitive) |
No output schema declared.
No examples provided.
zotero_list_windows ~37
List all open Zotero windows with their IDs, types, and titles. Use the windowId in other tools to target specific windows.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
zotero_open_preferences ~141
Open Zotero's preferences/settings window. Optionally navigate directly to a specific pane. For built-in panes, use: 'general', 'sync', 'export', 'cite', 'advanced'. For plugin panes, use the plugin ID (e.g., '[email protected]' or just 'zotseek').
| Name | Type | Req | Description |
|---|---|---|---|
| paneId | string | — | Optional pane ID to navigate to. Built-in: 'general', 'sync', 'export', 'cite', 'advanced'. For plugins: use the plugin ID (e.g., '[email protected]'). If omitted, opens to the last viewed pane. |
No output schema declared.
No examples provided.
zotero_ping ~39
Test connection to Zotero and get version info. Use this to verify that Zotero is running and the MCP Bridge for Zotero plugin is active.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
zotero_plugin_install ~51
Install a Zotero plugin from a local XPI file. The plugin will be installed and Zotero may need to be restarted.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Path to the XPI file to install |
No output schema declared.
No examples provided.
zotero_plugin_list ~29
List all installed Zotero plugins/add-ons with their IDs, names, versions, and status.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
zotero_plugin_reload ~69
Reload a Zotero plugin. If a plugin ID is provided, reloads that specific plugin. Otherwise attempts to reload based on the current project.
| Name | Type | Req | Description |
|---|---|---|---|
| pluginId | string | — | Plugin ID to reload (e.g., '[email protected]'). Use zotero_plugin_list to find IDs. |
No output schema declared.
No examples provided.
zotero_read_errors ~48
Read errors from Zotero's error console. Returns JavaScript errors with stack traces and source locations.
| Name | Type | Req | Description |
|---|---|---|---|
| lines | number | — | Number of recent errors to return (default: 20) |
No output schema declared.
No examples provided.
zotero_read_logs ~78
Read Zotero's debug log output. Shows recent debug messages from Zotero.debug() calls.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | string | — | Filter logs containing this string (case-insensitive) |
| level | string | — | Filter by log level (default: all) |
| lines | number | — | Number of recent lines to return (default: 100) |
No output schema declared.
No examples provided.
zotero_scaffold_build ~74
Build a Zotero plugin project using zotero-plugin-scaffold. Runs 'npm run build' or 'npm run build:dev' in the project directory.
| Name | Type | Req | Description |
|---|---|---|---|
| mode | string | — | Build mode (default: development) |
| projectPath | string | — | Path to plugin project (default: current working directory) |
No output schema declared.
No examples provided.
zotero_scaffold_lint ~54
Run ESLint on a Zotero plugin project.
| Name | Type | Req | Description |
|---|---|---|---|
| fix | boolean | — | Automatically fix problems (default: false) |
| projectPath | string | — | Path to plugin project (default: current working directory) |
No output schema declared.
No examples provided.
zotero_scaffold_serve ~68
Start/stop the zotero-plugin-scaffold dev server with hot reload. This watches for changes and automatically rebuilds/reloads the plugin.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | Action to perform |
| projectPath | string | — | Path to plugin project (default: current working directory) |
No output schema declared.
No examples provided.
zotero_scaffold_typecheck ~42
Run TypeScript type checking on a Zotero plugin project.
| Name | Type | Req | Description |
|---|---|---|---|
| projectPath | string | — | Path to plugin project (default: current working directory) |
No output schema declared.
No examples provided.
zotero_screenshot ~160
Capture a screenshot of Zotero. Can capture the main window, a specific window, or a specific element by CSS selector. Optionally highlight an element with a red border.
| Name | Type | Req | Description |
|---|---|---|---|
| format | string | — | Image format (default: png) |
| highlightSelector | string | — | CSS selector for element to highlight with red border before capture |
| scale | number | — | Scale factor for the screenshot (default: 1) |
| selector | string | — | CSS selector for element to capture (required if target='element') |
| target | string | — | What to capture: main-window (default), specific window, or element |
| windowId | number | — | Window outerWindowID (use zotero_list_windows to find). Required if target='window' |
No output schema declared.
No examples provided.
zotero_search_prefs ~129
Search and list Zotero/Firefox preferences. Use to discover available preference keys before using zotero_get_pref/zotero_set_pref. Can filter by branch prefix (e.g., 'extensions.zotero.') and/or substring pattern.
| Name | Type | Req | Description |
|---|---|---|---|
| branch | string | — | Preference branch to list (e.g., 'extensions.zotero.', 'general.'). Defaults to 'extensions.zotero.' if not specified. |
| limit | number | — | Maximum number of results to return (default: 50) |
| pattern | string | — | Substring filter for preference names (case-insensitive) |
No output schema declared.
No examples provided.
zotero_send_keys ~233
Type text into an element in a Zotero window (an input/textarea or any contenteditable). If a selector is given the element is focused first (light DOM, then open shadow roots); otherwise the window's active element is used. Fires input/change events so listeners react. Optionally clear first and/or press Enter afterwards. Note: a few widgets (e.g. Zotero's quick-search) only fully react to their own command handler, not a raw input event — prefer a direct field where possible.
| Name | Type | Req | Description |
|---|---|---|---|
| clear | boolean | — | Clear the field before typing (default false) |
| pressEnter | boolean | — | Dispatch an Enter keydown/keypress/keyup after typing (default false). Note: these events are untrusted (isTrusted=false) and some widgets ignore them — a direct input + change is more reliable where… |
| selector | string | — | CSS selector for the target field (optional; defaults to the active element) |
| text | string | yes | Text to type into the element |
| windowId | number | — | Window outerWindowID (optional, defaults to main window) |
No output schema declared.
No examples provided.
zotero_set_pref ~50
Set a Zotero preference value. Use with caution - some preferences require restart.
| Name | Type | Req | Description |
|---|---|---|---|
| key | string | yes | Preference key |
| value | — | yes | Value to set (string, number, or boolean) |
No output schema declared.
No examples provided.
zotero_watch_logs ~52
Start/stop watching for new log messages. Use action='start' to begin collecting, 'get' to retrieve collected logs, 'stop' to end.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | Action to perform |
No output schema declared.
No examples provided.