DocsAgent는 AI 에이전트에게 개인 지식 기반에 즉각적이고 사적인 접근을 제공합니다. **docsagent**는 규격 기반 MCP(모델 컨텍스트 프로토콜) 서버입니다. 모든 AI 에이전트 — Claude Desktop, Cursor, Cline, Qwen Code 또는 모든 MCP 클라이언트 — 를 검색, 읽기, 그리고 거주자를 통해 Zotero 라이브러리, Obsidian 금고, Apple Notes(macOS)를 작성하세요 C++ 검색 엔진. BM25 전체 텍스트 검색 + 1,000+ PDF 이상의 쿼리 순위별 지문 검색 **~15 ms*에서 완전 로컬 (RAG 준비 지식 베이스).

• 🔒 로컬 우선 및 프라이빗 — 엔진이 당신의 Zotero 라이브러리, Obsidian Vault를 읽습니다 Apple Notes는 컴퓨터에 직접 저장됩니다. 노트와 PDF는 절대 기기를 떠나지 않습니다.
• 🗂 세 가지 출처, 하나의 쿼리 — 조테로 항목/주석/노트, 옵시디언 금고, 그리고 애플 노트(macOS 전용); 혼합 검색은 세 가지 모두를 상호 순위로 융합합니다.
• ⚡ 네이티브 C++ 검색 코어 — 역인덱스 BM25 + 지문 순위, 밀리초 조회, 메모리 사용량이 적음(1,500종이 도서관의 경우 160–227MB).
• 🧩 8 MCP 도구 — 5 읽기 + 3 쓰기, JSON 스키마 검증 인수, 토큰 예산 포함, 결과 디디업과 3계층 쓰기 안전 게이트가 있습니다.

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