DocsAgent предоставляет агентам ИИ мгновенный, приватный доступ к вашей личной базе знаний. docsagent — это сервер, управляемый спецификациями MCP (Model Context Protocol), который позволяет любой AI-агент — Claude Desktop, Cursor, Cline, Qwen Code или любой MCP-клиент — поиск, чтение и пишите свою библиотеку Zotero, Obsidian хранилище и Apple Notes (macOS) через резидента Поисковая система C++. Полнотекстовый поиск BM25 + поиск отрывков с ранжированием запросов по 1 000+ PDF на ~15 мс, полностью локальная (база знаний, готовая к RAG).

• 🔒 Local-first и private — движок считывает вашу библиотеку Zotero, хранилище Obsidian и Apple Notes хранится прямо на вашем компьютере. Ваши заметки и PDF никогда не покидают его.
• 🗂 Три источника, один запрос — предметы/аннотации/заметки Zotero, хранилища из обсидиана и Apple Notes (только для macOS); смешанный поиск объединяет все три по взаимному рангу.
• ⚡ Нативное ядро поиска C++ — инвертированный индекс BM25 + ранжирование пассажей, миллисекундный поиск, небольшой объем памяти (160–227 МБ для библиотеки из 1500 бумаг).
• 🧩 8 MCP-инструментов — 5 чтения + 3 записи, с валидированными JSON-схемами аргументами, бюджетами токенов, Результат DedUp и трёхслойный защитный элемент записи.

DocsAgent MCP — Zotero, Obsidian & Apple Notes for AI agents 📚⚡

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 Zotero library, Obsidian vault, and Apple Notes (macOS) through a resident C++ search engine. BM25 full-text search + query-ranked passage retrieval over 1,000+ PDFs at ~15 ms, fully local (RAG-ready knowledge base).

• 🔒 Local-first & private — the engine reads your Zotero library, Obsidian vault, and Apple Notes store directly on your machine. Your notes and PDFs never leave it.
• 🗂 Three sources, one query — Zotero items/annotations/notes, Obsidian vaults, and Apple Notes (macOS only); mixed search fuses all three by reciprocal rank.
• ⚡ Native C++ search core — inverted-index BM25 + passage ranking, millisecond lookup, low memory footprint (160–227 MB for a 1,500-paper library).
• 🧩 8 MCP tools — 5 read + 3 write, with JSON-schema validated arguments, token budgets, result dedup, and a three-layer write safety gate.
• 🌐 Two transports — stdio for local MCP clients, Streamable HTTP for remote deployment (origin checks, API-key / OAuth 2.0 token introspection, per-request RBAC, /health probe).
• 🐍 Two shells, one core — this TypeScript package and a feature-equal Python wrapper ship the same tools over the same JSON-RPC contract.

---

Architecture

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/.

---

Quick Start

1. Start the core

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):