Highlights / 亮点
- Group library support 群组文库支持 (#50 by @Elenoxe, closes #63): all search, collection, content and write tools now accept an optional
libraryID; newget_libraries/search_librariestools to discover library IDs. Objects in not-yet-opened group libraries are loaded on demand. - Import local files as attachments 本地文件导入 (#76 by @441837297, for #79/#66):
write_itemgains animportaction — attach a local PDF/file to an item viaZotero.Attachments.importFromFile, group libraries supported. - Semantic index no longer stalls on bad items 索引不再被单个条目卡死 (#74, #48, #49, integrating #53 by @annosoo): item-local embedding failures (400/413/oversized) are skipped, persisted, and retryable via a new Retry Failed button; oversized chunks are truncated instead of aborting the build; provider context-overflow 400s (dashscope/ollama) are recognized; global errors (auth/network/rate-limit/5xx) still pause safely. Concurrent-build races between Resume and auto-indexing are fixed.
- Configurable embedding API timeout 可配置嵌入超时 (#59): 5–600s preference, takes effect immediately, used by Test Connection too.
- Zotero 9/10 compatibility:
strict_max_versionraised to 10.99.99 (Zotero 9 needs no code changes; ready for the new 6–10 week release cycle); toolkit/types/scaffold bumped to stable releases.
Fixes / 修复
get_contentcomplete mode no longer freezes Zotero or drops the connection on large HTML snapshots; very long documents no longer stall summarization (#78, helps #26)- CJK request bodies: Content-Length compared in UTF-8 bytes, converter-buffered data drained — multibyte POSTs no longer stall/truncate (#54 by @Xnjikol, likely fixes #70)
- Disabling the plugin no longer breaks the item right-click menu (#69)
get_item_abstractworks withformat="text"(#52)- Dimension setting aligned across UI / Test Connection / Ollama native API; MRL models (qwen3-embedding etc.) supported (#62)
add/remove_items_to_collectionaccepts string-serializeditemKeysfrom quirky MCP clients (#71)- Chatbox config uses native HTTP transport (#55 by @gaoyu19920914); new WorkBuddy preset (#75)
.well-knownOAuth probes no longer treated as MCP sessions; JSON 404s with correct Content-Length
Install / 安装
Download zotero-mcp-plugin-1.5.0.xpi and install via Zotero Tools -> Add-ons. Existing installs update automatically.