适合谁
- 希望私有、自托管、版本精准地为 AI 编程助手提供文档依据的开发者
- 需要索引内部文档或第三方文档、且不希望代码离开自身网络的团队
D
65FMRS · C
这是一个文档齐全、MIT 许可的开源 MCP 服务器，支持广泛的文件格式，并提供 CLI、Web 界面与 MCP 三种使用方式；非官方维护（由社区开发者 arabold 维护，并非 Context7 等产品或 MCP 协议方的官方实现），README 中明确给出的客户端配置示例仅涉及 SSE 传输方式。
Docs MCP Server（Grounded Docs）是一个自托管的 MCP 服务器，用于从网站、GitHub、npm、PyPI 及本地文件抓取并索引最新、版本精准的文档，供 AI 编程助手查询真实文档，而非依赖过时的训练数据。它提供 Web 界面、CLI 以及 MCP 端点（如 scrape_docs 工具）用于索引与搜索文档，并可选配嵌入模型以支持语义搜索。
工具能力
scrape_docs
从指定 URL 抓取并索引文档内容，写入服务器的搜索索引；支持 preserveHashes 参数以处理基于哈希路由的单页应用（SPA）文档站点。
安装接入
运行 npx @arabold/docs-mcp-server@latest（需要 Node.js 22+）启动服务器，然后打开 http://localhost:6280 通过 Web 界面添加文档。也可使用 Docker 镜像 ghcr.io/arabold/docs-mcp-server:latest 并加上 --protocol http --host 0.0.0.0 --port 6280 参数运行。在 MCP 客户端配置文件（如 claude_desktop_config.json）中添加该服务器，指向 SSE 端点 http://localhost:6280/sse。如需更好的语义搜索效果，可在启动前设置嵌入模型的 API 密钥（例如 OPENAI_API_KEY）。
claude_desktop_config.json
{
"mcpServers": {
"docs-mcp-server": {
"type": "sse",
"url": "http://localhost:6280/sse"
}
}
}
选型与风险
不适合谁
- 需要零配置托管服务、不想自行运行服务器的用户
- 需要立即查询尚未被抓取索引的文档的用户（必须先执行抓取）
- 要求搜索结果100%准确、不接受关键词或语义检索偶有偏差的场景
所需权限
- 访问外部网络以从网站、GitHub、npm、PyPI 抓取文档
- 读取本地文件、文件夹及压缩包（当索引本地来源时）
- 本地磁盘/存储空间用于保存文档索引（Docker 部署时对应 /data、/config 卷）
- 如启用语义搜索，需要访问第三方嵌入模型提供商（如 OpenAI）的网络出口及 API 密钥
- 监听本地网络端口（默认 6280）以提供 Web 界面和 MCP 端点
风险与副作用
- 抓取并索引任意外部 URL 时，可能引入不受信任或恶意的内容
- 若将服务绑定到 0.0.0.0 且未配置身份验证（OAuth2/OIDC），Web 界面与 MCP 端点及已索引文档可能被网络内任何人访问
- 处理不受信任的压缩包、Office 文档、PDF 等文件时存在解析漏洞的一般性风险
- 嵌入模型的 API 密钥（如 OPENAI_API_KEY）以环境变量形式提供，并会被发送至第三方服务商
常见排障
- 确认已安装 Node.js 22 及以上版本以运行 npx CLI
- 若 Web 界面无法访问，检查 6280 端口是否被占用或可达
- 使用 --verbose 查看调试日志，或使用 --quiet 抑制非交互模式下的诊断输出
- 针对哈希路由的 SPA 文档站点，启用 --preserve-hashes 或 MCP 的 preserveHashes 参数
- 若语义搜索效果不佳，检查是否已配置嵌入模型的 API 密钥（如 OPENAI_API_KEY）
- 若重启后索引数据丢失，检查 Docker 卷挂载（-v docs-mcp-data、-v docs-mcp-config）是否正确
- 如需将服务暴露到本机以外，参考安全与身份验证相关文档配置访问控制
使用场景
为常用库或框架建立最新文档索引，减少大模型产生幻觉的概率
让 AI 编程助手查询项目实际使用的库版本对应的文档
索引本地文件、zip/tar 压缩包、PDF、Office 文档等，构建私有文档搜索库
通过 Claude Desktop、VS Code（Cline/Roo）等 MCP 客户端查询已索引的文档
支持客户端
Claude Desktop完整支持
Cline部分支持
VS Code部分支持
GitHub Copilot部分支持
Gemini CLI部分支持