Grounded Docs：你的 AI 的最新文档专家

Docs MCP Server 通过为你的 AI 编程助手提供个人化、始终最新的文档索引，解决了 AI 幻觉和知识过时的问题。它从网站、GitHub、npm、PyPI 和本地文件获取官方文档，让你的 AI 能够查询你正在使用的确切版本。

✨ 为什么选择 Grounded Docs MCP Server？

作为 Context7、Nia 和 Ref.Tools 的开源替代品。

• ✅ 最新上下文： 按需直接从官方来源获取文档。
• 🎯 版本特定： 查询针对你项目中的确切库版本。
• 💡 减少幻觉： 将 LLM 基于真实文档。
• 🔒 私密且本地化： 完全在你的机器上运行；你的代码永远不会离开你的网络。
• 🧩 广泛兼容性： 适用于任何兼容 MCP 的客户端（Claude、Cline 等）。
• 📁 多来源： 索引网站、GitHub 仓库、本地文件夹和 zip 压缩包。
• 📄 丰富的文件支持： 处理 HTML、Markdown、PDF、Office 文档（Word、Excel、PowerPoint）、OpenDocument、RTF、EPUB、Jupyter Notebook 以及 90+ 种源代码语言。

---

📄 支持的格式

| 类别 | 格式 | |------|------| | 文档 | PDF、Word (.docx/.doc)、Excel (.xlsx/.xls)、PowerPoint (.pptx/.ppt)、OpenDocument (.odt/.ods/.odp)、RTF、EPUB、FictionBook、Jupyter Notebooks | | 压缩包 | ZIP、TAR、gzipped TAR（内容会被解压并单独处理） | | 网页 | HTML、XHTML | | 标记语言 | Markdown、MDX、reStructuredText、AsciiDoc、Org Mode、Textile、R Markdown | | 源代码 | TypeScript、JavaScript、Python、Go、Rust、C/C++、Java、Kotlin、Ruby、PHP、Swift、C# 以及 更多 | | 数据 | JSON、YAML、TOML、CSV、XML、SQL、GraphQL、Protocol Buffers | | 配置 | Dockerfile、Makefile、Terraform/HCL、INI、dotenv、Bazel |

查看 支持的格式 获取完整参考，包括 MIME 类型和处理细节。

---

🚀 快速开始

命令行优先

对于代理和脚本，CLI 通常是使用 Grounded Docs 的最简单方式。

1. 索引文档（需要 Node.js 22+）：

npx @arabold/docs-mcp-server@latest scrape react https://react.dev/reference/react

对于使用哈希路由的 SPA 文档站点，请显式启用哈希保留：

npx @arabold/docs-mcp-server@latest scrape my-spa https://docs.example.com/#/guide --preserve-hashes

2. 查询索引：

npx @arabold/docs-mcp-server@latest search react "useEffect cleanup" --output yaml

3. 将单个页面获取为 Markdown：

npx @arabold/docs-mcp-server@latest fetch-url https://react.dev/reference/react/useEffect

输出行为

• 在非交互式运行中，结构化命令默认在 stdout 上输出干净的 JSON。
• 使用 --output json|yaml|toon 选择结构化格式。
• 纯文本命令（如 fetch-url）会将其文本内容保留在 stdout 上。
• 诊断信息通过共享日志器输出，在非交互式运行中不会出现在 stdout 上。
• 使用 --quiet 抑制非错误诊断信息，或使用 --verbose 启用调试输出。

代理技能

skills/ 目录包含 Agent Skills，它们教 AI 编程助手如何使用 CLI——涵盖文档搜索、索引管理和 URL 获取。

MCP 服务器

如果你想要一个长期运行的 MCP 端点，用于 Claude、Cline、Copilot、Gemini CLI 或其他 MCP 客户端：

1. 启动服务器：

npx @arabold/docs-mcp-server@latest

2. 打开 Web UI，访问 http://localhost:6280 以添加文档。

3. 连接你的 AI 客户端，将此添加到你的 MCP 设置中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "docs-mcp-server": {
      "type": "sse",
      "url": "http://localhost:6280/sse"
    }
  }
}

查看 连接客户端 了解 VS Code（Cline、Roo）和其他设置选项。

scrape_docs 也接受 preserveHashes: true，适用于使用基于哈希的客户端路由的文档站点。 仅对哈希路由的 SPA 使用此选项；普通站点通常使用哈希片段作为页内锚点。

替代方案：使用 Docker 运行

docker run --rm \
  -v docs-mcp-data:/data \
  -v docs-mcp-config:/config \
  -p 6280:6280 \
  ghcr.io/arabold/docs-mcp-server:latest \
  --protocol http --host 0.0.0.0 --port 6280

🧠 配置嵌入模型（推荐）

使用嵌入模型是可选的，但通过启用语义向量搜索，可以显著提高搜索质量。

示例：启用 OpenAI 嵌入

OPENAI_API_KEY="sk-proj-..." npx @arabold/docs-mcp-server@latest

查看 **[嵌入模型](docs/guides…