v0.1.0 — MCP server for Claude Code / Cursor / Codex CLI

What's new

DeepRead now ships an MCP (Model Context Protocol) server. Use your existing Claude Code / Cursor / Codex CLI / Copilot subscription to chat with your Zotero library — no separate API key needed.

Install

Zotero plugin — download zotero-copilot-0.1.0.xpi and install via Tools → Plugins → ⚙ → Install Plugin From File.

MCP server (after the plugin) — turn on Settings → DeepRead → Enable MCP server, then in your IDE:

• Claude Code: claude mcp add --scope user deepread -- npx -y deepread-mcp
• Cursor: click "Add to Cursor" in plugin settings (one-click deeplink)
• Codex CLI: paste the snippet shown in plugin settings into ~/.codex/config.toml
• Other MCP clients: copy the generic JSON config from plugin settings

See docs/MCP.md for full details.

7 tools exposed

search_library, get_item, get_item_fulltext, list_collections, search_collection, rag_query, get_annotations

rag_query reuses the same embedding index the in-Zotero sidebar builds — no double indexing.

Other changes

• Restructured to npm-workspaces monorepo (packages/{shared, zotero-plugin, mcp-server})
• All previous features unchanged: sidebar chat, collection RAG overlay, prefs pane, copy controls, collapsible sidebar
• Same plugin id zotero-copilot@xiangweiw.dev and same pref namespace, so 0.0.x users upgrade in place without losing API keys / collection indexes

Known caveats

• MCP server is off by default — toggle it in Settings → DeepRead before connecting any client
• Tools are read-only — annotation write-back lands in the next release
• Long RAG queries: stdio bridge has a soft ~60s timeout in some clients; rag_query returns top-K excerpts so the model synthesizes the answer (rather than the server doing slow synthesis)

Full Changelog: v0.0.2...v0.1.0