Augments MCP Server 是一个通过 Model Context Protocol（MCP）为 Claude Code 提供实时框架文档访问的服务器。其 MCP 名称为 dev.augments/mcp，旨在为任意 npm 包返回类型、说明文字和示例，并采用上下文感知的格式化方式，而不仅限于精选的包。
主要能力
- 文档优先搜索（v7 新增）：类似“prisma findMany with pagination”或“zustand create store with middleware”的查询现在会返回真实的文档内容。BM25 搜索引擎按标题分块索引从 GitHub 获取的文档，并支持 API 名称加权和同义词扩展。
- 概念同义词：25 个同义词簇覆盖 state、form、fetch、animation、routing、auth、cache、effect、middleware、pagination、validation、testing、streaming、error handling、database、layout、modal、table、upload、realtime、deployment、i18n、SSR、component 和 context 模式。双向查找意味着“usestate”会扩展到“state”簇。
- 意图感知格式化。
- 生产级可靠性（v7 新增）：npm registry 重试采用带抖动的指数退避，并支持 429 Retry-After；CDN 熔断器会跳过反复失败的 CDN 端点（5 分钟内 3 次失败）；GitHub 速率限制会跟踪剩余配额，耗尽时跳过获取；所有使用缓存的模块均采用带命中/未命中统计的 LRU 缓存。
- 支持任意 npm 包：每个 npm 包开箱即用，无需精选或配置。Augments 通过四层机制自动解析文档：文档搜索（从 GitHub 仓库获取真实文档，用 BM25 索引）、TypeScript 类型（包内自带的 "types" 或 DefinitelyTyped 的 @types/*）、自动发现文档（解析 npm repository 字段，找到 GitHub 仓库，探测 docs/ 目录）、README 回退（从 README.md 中提取与概念相关的代码块和说明文字）。这意味着 augments 适用于整个 npm 生态（约 250 万包），而不仅是精选子集。
- 流行框架增强结果：22 个框架拥有精选文档源以提供更丰富的示例，包括 React、Next.js、Vue、Prisma、Zod、Supabase、TanStack Query、tRPC、React Hook Form、Framer Motion、Express、Zustand、Jotai、Drizzle、SWR、Vitest、Playwright、Fastify、Hono、Solid、Svelte、Angular、Redux。
- Barrel 导出处理：针对 React Hook Form、TanStack Query、Zustand、Jotai、tRPC、Drizzle ORM、Next.js 提供特殊子模块解析。
使用方式 将以下内容添加到 MCP 配置中（具体配置格式资料未提供完整示例）。可设置环境变量 GITHUB_TOKEN 以提高获取示例和文档时的 GitHub API 速率限制。
本地开发与贡献
- Fork 仓库
- 创建功能分支：git checkout -b feature/amazing-feature
- 进行修改
- 运行测试：npm test
- 提交 pull request
适用场景 适用于使用 Claude Code 进行开发、需要实时查询框架或 npm 包文档、类型和示例的开发者。
限制 资料未提供具体的收费、价格、平台支持范围或性能指标。文档中提及“How Augments Compares to Context7”但未给出具体对比内容。
许可证 MIT License，详见 LICENSE。
