DevDocs-MCP 是一个为 AI 代理提供文档权威的本地 MCP 服务器，基于 DevDocs.io 的文档数据集，旨在消除 AI 幻觉，提供版本感知且确定性的文档。
【用途】 DevDocs-MCP 作为 AI 代理与文档源之间的中间件，解决现代 AI 编程代理面临的三大难题：幻觉（猜测 API 签名或使用已弃用方法）、延迟（每次查询都获取在线文档缓慢）、版本漂移（混淆 React 18 与 React 19 特性）。它通过从本地存储按需检索文档，并根据项目特定依赖版本进行过滤，为 AI 助手提供“及时”文档。
【主要能力】
- 离线优先：文档缓存于本地，摄取后无需互联网。
- 排序模糊搜索：快速找到相关条目（如“intersection observer”）。
- 版本感知：自动映射到项目中特定库版本。
- 纯 Node 架构：使用 sql.js 实现零原生依赖（无需 Python/C++ 构建步骤）。
- 结构化输出：返回干净、针对 LLM 优化的内容。
- 项目感知上下文管理器：将文档固定到 package.json 版本。
- 惰性摄取引擎：离线缓存 DevDocs。
【使用方式】
- 环境要求：Node.js 18+（已在 18.x 和 20.x 测试）。
- 克隆与安装：使用 pnpm 进行开发与贡献（严格推荐）。
- 配置环境：.env 文件中通过 DEVDOCS_VOLUME_SOURCE 支持 3 种存储模式：命名卷（默认，Docker 管理）、主机路径（如 ./my-docs-storage）。
- 启动服务器：docker compose up -d 或直接运行公共镜像。
- 统一挂载点 /app/data 包含 mcp.db（SQLite 注册表）和 docs/（缓存文档文件）。
- 在 .env 中配置存储后启动，每次可指向新卷或已有卷。
- 摄取文档：服务器连接代理后，使用 ingest 工具下载特定技术栈文档；代理会自动处理，列出可用工具并决策。
- AI 代理配置：RooCode/Cline/Claude Desktop 推荐 STDIO 方式，在 mcp_settings.json 中添加配置，设置 cwd 加载 .env 并使用相对路径；远程/Web 客户端可用 HTTP SSE，启动时带 --port 3000，客户端配置 SSE URL http://your-server:3000/mcp/sse，类型 SSE。
【适用场景】 适用于使用 AI 编程代理进行开发的场景，尤其是需要精确 API 文档、避免版本混淆、网络受限或追求低延迟的本地开发环境。支持多种代理和客户端。
【限制】
- 项目状态：处于活跃且大量开发中，仍需测试现有功能并实现更多新功能（如最优缓存、自动更新最新文档及按需更新、最优查询等）。设计决策、API 和结构预计会基于社区反馈演变。
- 非 AI 代理或代码生成器。
- 非网页爬虫（使用结构化 DevDocs 数据集）。
- 非 DevDocs 界面替代品。
- 非托管 SaaS（100% 本地运行）。
- 开发与贡献严格使用 pnpm。
- DevDocs 获取 URL 定义在 src/config/constants.ts，若社区更改路径需更新配置。
- 官方未提供具体收费、价格、平台或效果数据。
- 许可证：MIT。
