agents-docs
agents-docs
面向 AI 编码代理的超快速、零臃肿本地 Markdown 文档 RAG,通过 MCP 提供。
对官方框架文档和实时 AI 模型注册表进行即时 BM25 搜索。共享于 Cursor、Claude Code、Antigravity 和 Zed。
为什么选择 .agents/docs?
编码代理经常幻觉出已弃用的 API(Svelte 4 与 5 Runes、Tailwind v3 与 v4、React 19 Actions),或引用过时的 LLM 模型和 token 定价。
传统的向量嵌入 RAG 解决方案臃肿:它们需要 Docker 容器、数百兆字节的 Python 依赖(Chroma、LangChain),以及会拆分代码块的缓慢的 API 嵌入调用。
agents-docs 应用 Lolaplex 哲学:
零向量数据库:感知标题的 Markdown 分块 + 纯 Python 词法 BM25 排名,带有标题匹配提升(+6.0)和完整短语提升(+10.0)。
亚 10 毫秒搜索:直接从磁盘上的纯 Markdown 文件(
~/.agents/docs/)即时检索。实时 AI 模型注册表:实时跟踪前沿和开放权重模型(Claude 5/4、GPT-5/o3/o4、Gemini 3.x、DeepSeek V4/R1、Qwen 2.5 Coder)的上下文窗口、基准测试和 token 定价($/1M)。
精选 21+ 框架目录:一键同步官方
llms.txt(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 包装器、链接噪声和 cookie 横幅,而不改变代码块或表格。
通用 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 注册表,自动将 MCP 配置接入你已安装的 IDE,并注册助手技能。
[!TIP] 🤖 代理驱动设置(零摩擦): 只需告诉你的编码代理:"为我安装并设置 agents-docs。" 代理会安装该包,运行
agents-docs init,并在你询问技术栈或模型定价问题时自动获取最新文档。
CLI 参考
命令 | 用途 |
| 即插即用设置:自动配置所有 IDE 中的 MCP 并安装模型文档 |
| 列出所有 21+ 预配置框架和模型目录 |
| 一键下载/更新官方框架文档 |
| 摄取任何自定义 |
| 在所有已安装的文档集中进行快速 BM25 搜索 |
| 在特定文档集内进行范围搜索 |
| 对所有已安装文档集进行就地噪声和样板清理 |
| 列出磁盘上所有已安装的文档集,包含文件和字节计数 |
| 运行 FastMCP stdio 服务器(默认) |
MCP 工具参考
工具 | 参数 | 描述 |
| 无 | 列出 |
|
| 在毫秒内返回带标题和代码块的最匹配 Markdown 部分。按需自动同步缺失的目录文档集。 |
|
| 返回特定文件的原始 Markdown 内容。 |
| 无 | 列出所有 21+ 预配置框架和模型目录,可供一键同步。 |
|
| 从目录或自定义 |
|
| 检查 |
| 无 | 扫描 |
支持的生态系统
Claude Code: 通过 MCP 服务器和
.agents/skills/docs-search绑定。Google Antigravity: 通过
.gemini/config规则和agents-docsMCP 集成。Cursor: 自动配置
.cursor/mcp.json和代理规则。Zed: 配置
context_servers并镜像助手技能。VS Code / Windsurf: 自动接线 Cline / Roo-Code MCP 配置。
开放 ABI 规范
详细的架构规范位于 abi/:
abi/WHY.md— 架构理由与 BM25 与向量嵌入的对比。abi/LAYOUT.md—~/.agents/docs/中的存储分类。abi/MCP.md— 工具表面定义和模式。abi/CATALOG.md— 精选目录模式和受支持的类型。abi/LLMSTXT.md— 对llms.txt标准的支持。
测试与验证
在所有引擎上运行测试套件:
python tests/run_all_tests.py许可证
MIT 许可证。详情请参阅 LICENSE。
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server that gives AI coding agents on-demand access to private project docs via BM25 ranked search. One setup for Claude Code, Cursor, Codex, Gemini CLI, and more. Docs stay private, never in public repos.1515Apache 2.0

Speakeasy Docs MCPofficial
AlicenseNot gradedqualityCmaintenanceA lightweight, domain-agnostic hybrid search engine for markdown corpora, exposed via the Model Context Protocol (MCP), optimized for serving SDK documentation to AI coding agents.7AGPL 3.0- AlicenseNot gradedqualityBmaintenanceLocal-first context retrieval engine that serves precise documentation chunks to coding agents via MCP, ensuring high-confidence context for code generation.MIT
Related MCP Connectors
Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.
Multi-engine search for AI agents. Trust scoring, local corpus, MCP-native. Self-hostable, BYOK.
Token-efficient search for coding agents over public and private documentation.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lolaplex/agents-docs'
If you have feedback or need assistance with the MCP directory API, please join our Discord server