agents-docs

MCP를 통해 AI 코딩 에이전트를 위한 초고속, 제로 블로트 로컬 마크다운 문서 RAG.
공식 프레임워크 문서와 실시간 AI 모델 레지스트리에 대한 즉각적인 BM25 검색. Cursor, Claude Code, Antigravity, Zed에서 공유됩니다.

왜 .agents/docs인가?

코딩 에이전트는 종종 더 이상 사용되지 않는 API(Svelte 4 vs 5 Runes, Tailwind v3 vs v4, React 19 Actions)를 환각하거나 오래된 LLM 모델과 토큰 가격을 참조합니다.

기존의 벡터 임베딩 RAG 솔루션은 비대합니다: Docker 컨테이너, 수백 메가바이트의 Python 의존성(Chroma, LangChain), 그리고 코드 블록을 반으로 쪼개는 느린 API 임베딩 호출이 필요합니다.

agents-docs는 Lolaplex 철학을 적용합니다:

• 제로 벡터 DB: 헤더 인식 마크다운 청킹 + 헤더 매치 부스트(+6.0) 및 전체 구문 부스트(+10.0)를 적용한 순수 Python 어휘 BM25 랭킹.

• 10ms 미만 검색: 디스크의 일반 마크다운 파일(~/.agents/docs/)에서 직접 즉시 검색.

• 실시간 AI 모델 레지스트리: Frontier 및 Open-Weights 모델(Claude 5/4, GPT-5/o3/o4, Gemini 3.x, DeepSeek V4/R1, Qwen 2.5 Coder)의 실시간 추적 컨텍스트 윈도우, 벤치마크, 토큰 가격($/1M).

• 큐레이션된 21+ 프레임워크 카탈로그: 공식 llms.txt 1클릭 동기화(TypeScript Handbook, Svelte 5, FastAPI, Tailwind v3/v4, Tauri 2, Next.js, Supabase, Hono, WXT, Netlify, Coolify, Cloudflare, Resend, React, Vite, Zod, Pydantic, shadcn/ui).

• 결정적 노이즈 제거: 코드 블록이나 테이블을 변경하지 않고 HTML 래퍼, 링크 노이즈, 쿠키 배너를 자동으로 제거.

• 유니버설 MCP 서버: 자동 동기화 및 의존성 매니페스트 검사 기능을 갖춘 FastMCP stdio 인터페이스.

Related MCP server: Speakeasy Docs MCP

아키텍처 및 흐름

 ┌─────────────────────────────────────────────────────────────┐
 │                  DOCS & MODEL REGISTRIES                    │
 │    Official llms.txt · TypeScript Handbook · OpenRouter     │
 └──────────────────────────────┬──────────────────────────────┘
                                │  agents-docs sync <name>
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                 DETERMINISTIC NOISE PRUNER                  │
 │    Strips HTML boilerplate while preserving 100% of code    │
 └──────────────────────────────┬──────────────────────────────┘
                                │  Header-aware chunking
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                   LOCAL DOCUMENTATION STORE                 │
 │   ~/.agents/docs/ai-models/       ~/.agents/docs/svelte-5/  │
 │   ~/.agents/docs/typescript/      ~/.agents/docs/fastapi/   │
 └──────────────┬───────────────────────────────┬──────────────┘
                │                               │
                ▼                               ▼
 ┌─────────────────────────────┐ ┌─────────────────────────────┐
 │        LEXICAL BM25         │ │     MCP SERVER & CLERK      │
 │  Header Match Boost (+6.0)  │ │  search_docs · list_docsets │
 │  Sub-10ms Exact Retrieval   │ │  sync_project_docs          │
 └─────────────────────────────┘ └─────────────────────────────┘

빠른 시작

1단계 설정

pip install agents-docs && agents-docs init

~/.agents/docs/를 스캐폴딩하고, 실시간 ai-models 레지스트리를 시드하며, 설치된 IDE에 MCP 구성을 자동 연결하고, 어시스턴트 스킬을 등록합니다.

[!TIP] 🤖 에이전트 주도 설정(제로 마찰):
코딩 에이전트에게 간단히 말하세요: "agents-docs를 설치하고 설정해 줘."
에이전트가 패키지를 설치하고 agents-docs init을 실행한 후, 기술 스택이나 모델 가격 질문을 할 때마다 최신 문서를 자동으로 검색합니다.

CLI 참조

MCP 도구 참조

지원 생태계

• Claude Code: MCP 서버 및 .agents/skills/docs-search를 통해 바인딩.

• Google Antigravity: .gemini/config 규칙 및 agents-docs MCP를 통해 통합.

• Cursor: .cursor/mcp.json 및 에이전트 규칙을 자동 구성.

• Zed: context_servers를 구성하고 어시스턴트 스킬을 미러링.

• VS Code / Windsurf: Cline / Roo-Code MCP 구성을 자동 연결.

공개 ABI 사양

자세한 아키텍처 사양은 abi/에 있습니다:

• abi/WHY.md — 아키텍처 근거 및 BM25 vs 벡터 임베딩.

• abi/LAYOUT.md — ~/.agents/docs/의 저장 분류 체계.

• abi/MCP.md — 도구 표면 정의 및 스키마.

• abi/CATALOG.md — 큐레이션된 카탈로그 스키마 및 지원 유형.

• abi/LLMSTXT.md — llms.txt 표준 지원.

테스트 및 검증

모든 엔진에서 테스트 스위트 실행:

python tests/run_all_tests.py

라이선스

MIT 라이선스. 자세한 내용은 LICENSE를 참조하세요.