Усильте агента
Собственная команда издателя. Не эндпоинт PlugMCP.
Host a copy with our keys and logs.
npx -y @docsagent/[email protected]У Claude Code нет ссылки для установки локальной команды. Скопируйте команду ниже и выполните её в терминале.
DOCSAGENT_CONFIG=<value> claude mcp add docsagent-docsagent -- npx -y @docsagent/docsagent@5.0.1Выполните в терминале.
{ "mcpServers": { "docsagent-docsagent": { "command": "npx", "args": [ "-y", "@docsagent/[email protected]" ], "env": { "DOCSAGENT_CONFIG": "<value>" } } }}claude_desktop_config.json
Удалённый URL или команда на вашем компьютере? Чем различаются два способа установки
Запустить на PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
ЗапускОт издателя
DocsAgent gives AI agents instant, private access to your personal knowledge base.
docsagent is the spec-driven MCP (Model Context Protocol) server that lets
any AI agent — Claude Desktop, Cursor, Cline, Qwen Code, or any MCP client — search, read, and
write your library, vault, and (macOS) through a resident
. BM25 full-text search + query-ranked passage retrieval over
at , fully local (RAG-ready knowledge base).
⚡ DocsAgent — give your AI agents instant, private access to your personal knowledge base (Zotero, Obsidian, Apple Notes supported now, local docs on the road). Native C++ search core: BM25 + passage ranking in ~15 ms. MCP server for Claude, Cursor, Cline & any MCP client.
/health probe).MCP Client (Claude Desktop / Cursor / Cline / Qwen Code / any MCP host)
│ stdio (local) or Streamable HTTP /mcp (remote)
▼
MCP shell ← this package (@docsagent/mcp-zotero / docsagent-mcp-zotero)
· tool schemas (spec-driven), argument validation, token budget, dedup
· write orchestration via the Zotero local API, write safety gate, RBAC
· group-library sync via the Zotero Web API
│ JSON-RPC 2.0 over HTTP ({coreHost}:{httpPort}/rpc, cpp-httplib)
▼
DocsAgent Core (resident C++ engine)
· reads ~/Zotero/zotero.sqlite + storage/, an Obsidian vault, and (macOS) the
Apple Notes store — directly on your machine
· builds & serves one index per source (BM25 + passage ranking); mixed search
(source "all") fuses them by reciprocal rank (RRF, k=60)
The shell never spawns the core during tool calls and never touches your source files. The core runs as a background service and stays available across MCP client restarts. Tool schemas and error codes: spec/.
npx @docsagent/docsagent start # spawn the bundled core for your platform
npx @docsagent/docsagent status # pid / endpoint / version
Python shell (same verbs, under the core subcommand):
pip install ./python # build the wheel locally (PyPI upload pending)
docsagent-mcp core start
(core stop / core restart also available. The core indexes every configured source — your
Zotero data directory, your Obsidian vault, and (macOS) Apple Notes — and serves JSON-RPC on
http://0.0.0.0:23120/rpc.)
Claude Desktop / Cursor / Cline / Qwen Code (mcpServers):
{
"mcpServers": {
"docsagent": {
"command": "npx",
"args": ["-y", "@docsagent/docsagent"]
}
}
}
Python shell (same tools, same contract, installed from this repo) — mcpServers:
{
"mcpServers": {
"docsagent-zotero-py": {
"command": "docsagent-mcp"
}
}
}
Install the Python package first (step 1) so docsagent-mcp is on your PATH.
On startup the shell connects to the core, loads sources, and checks index status. If the core is not running it fails fast with startup instructions — it never spawns anything.
8 tools, 5 read + 3 write. Schemas are the single-sourced contract in
spec/tools/*.json (mirrored into both packages); arguments are validated
before handlers run and failures map to typed docsagent error codes.
list_sourcesEvery searchable source with capabilities, supported targets/includes/browse modes, filters, and document counts. Call this first.
Sources today: zotero (targets items, annotations, notes; collections/tags browse),
obsidian (a vault — notes as items, folders/tags browse), and apple-notes (macOS only —
the engine omits the source on other platforms). The vault is found at
~/Documents/Obsidian Vault (override with DOCSAGENT_OBSIDIAN_VAULT); Apple Notes is read
from the system Notes store (override with DOCSAGENT_APPLE_NOTES_DB).
searchCross-entry search over one source (items, annotations, and notes).
Returns results[] with global ids (zotero:KEY, obsidian:<path>, apple-notes:<uuid>),
titles, relevance, snippets; multi-target
searches group by target. In mode=grep each result carries matchCount and snippets[]
hit windows (hits[] with line/column/offset, and meta hits tagged with field),
relevance is 0, and the response adds totalMatches. Results are deduped (id, then
normalized title + year) and packed under a token budget.
search runs against config.defaultSource (default zotero). Mixed search is a core
capability: pass source: "all" to the core's search / grep methods and every source is
ranked independently, then fused with reciprocal rank fusion (k=60) — each hit is tagged
with its source. BM25 scores are not comparable across corpora, so fusion is rank-based.
get_contentRead one entry. mode=passages (query-ranked passages, k) or mode=fulltext
(offset pagination with nextOffset). Notes return their body with tags and metadata.
get_metadatainclude: metadata, abstract, annotations, notes, citation (bibtex / csljson /
formatted via citationFormat/citationStyle). Notes are packed under the token budget.
list_libraryBrowse modes: collections (drill-down via parentId), items (by containerId),
tags, saved_searches, standalone_notes. Browse modes are per source — Zotero exposes
all of these, while Obsidian and Apple Notes expose folders (drill-down) / tags / items.
Write tools target Zotero sources only — the Obsidian and Apple Notes sources are read-only.
Write safety gate (spec/algorithms/write-gate.md): layer 1 write tools are not
registered unless enableWrites=true; layer 2 confirmed=false returns a preview and
consumes no rate-limit quota; layer 3 confirmed writes consume a per-hour rate limit
(default 30/h). Anything above 20 items in batch_modify additionally reports
requiresConfirmation in the preview.
The C++ engine powers PapersGPT — the same index and retrieval stack ships in this MCP server. Benchmark on a real Zotero installation (full write-up):
Config lives at ~/.docsagent/config.json (or $DOCSAGENT_CONFIG) — one file shared by
the JS shell, the Python wrapper, and the C++ core. Validated against
spec/config.json.
Bundled core platforms: macOS universal (Intel + Apple Silicon), Windows x64
(x86_64), Linux x64 (x86_64) — Linux ARM is not supported. Source availability:
Zotero and Obsidian work on every platform; Apple Notes is macOS-only (list_sources
omits it elsewhere).
Both shells read the same config and talk to the same core — pick either (or both) as
your MCP distribution channel. Core lifecycle (start / stop / restart / status)
is available from both CLIs.
Apache-2.0
⚡ DocsAgent — give your AI agents instant, private access to your personal knowledge base (Zotero, Obsidian, Apple Notes supported now, local docs on the road). Native C++ search core: BM25 + passage
{ "mcpServers": { "docsagent-docsagent": { "command": "npx", "args": [ "-y", "@docsagent/[email protected]" ], "env": { "DOCSAGENT_CONFIG": "<value>" } } }}Обзор
⚡ DocsAgent — give your AI agents instant, private access to your personal knowledge base (Zotero, Obsidian, Apple Notes supported now, local docs on the road). Native C++ search core: BM25 + passage ranking in ~15 ms. MCP server for Claude, Cursor, Cline & any MCP client.
Инструменты
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
Издатель указывает следующие переменные окружения: DOCSAGENT_CONFIG.
Docsagent работает локально через stdio.
Последняя проверка: 2026-10-26. ⚡ DocsAgent — give your AI agents instant, private access to your personal knowledge base (Zotero, Obsidian, Apple Notes supported now, local docs on the road). Native C++ search core: BM25 + passage ranking in ~15 ms. MCP server for Claude, Cursor, Cline & any MCP client.