docs-mcp-server

让AI助手实时读懂最新文档,告别过时代码幻觉

docs-mcp-server 是一个开源的 MCP(模型上下文协议)服务器,旨在为 AI 编程助手(如 Claude、Cursor)提供实时、精准的文档检索能力。它通过将各类技术文档(如 React、Next.js、Python 库等)转换为可被 AI 模型直接查询的上下文,解决了 AI 在生成代码时因文档过时而产生幻觉或错误的问题。核心能力包括:自动抓取并同步最新文档、支持语义搜索与关键词检索、提供结构化上下文片段供模型引用,并可作为 Context7、Nia 和 Ref.Tools 的免费替代方案。项目采用 TypeScript 编写,部署简单,支持自定义文档源,帮助开发者快速构建基于最新文档的 AI 辅助开发环境。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1755
维护状态 活跃
是否开源
定价模式 free

项目数据

分类开源模型
开发团队arabold
所属国家
定价模式free
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态
是否开源
开源协议MIT
主要语言TypeScript
技术栈/模型agentic-ai,copilot,cursor,llm,mcp,vscode,windsurf
GitHub 星标★ 1755
30天Star增速
HF 下载量
上线时间2025-03-17 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

难度:入门 约 20 分钟 部署方式:本地安装 5 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Node.js 环境(README 提到 npx 安装方式)
  • Docker(如选择 Docker 方式部署)
  • 一个支持 MCP 的 AI 客户端,如 Claude、Cline、Roo 等
  • 如需语义检索,准备嵌入模型服务:OpenAI、Ollama 或 Gemini

安装与启动步骤

  1. 1获取项目代码

    从 GitHub 克隆 docs-mcp-server 仓库到本地,README 中给出的地址为 arabold/docs-mcp-server。

    git clone https://github.com/arabold/docs-mcp-server
  2. 2阅读安装文档

    README 的 Quick Start 未直接给出安装命令,需按 docs/setup/installation.md 选择 Docker、Node.js(npx) 或 Embedded 模式。

  3. 3配置嵌入模型

    按 docs/guides/embedding-models.md 配置 OpenAI、Ollama、Gemini 等提供方,用于文档的语义检索。

  4. 4连接 MCP 客户端

    参照 docs/guides/mcp-clients.md,把服务器接入 Claude、VS Code(Cline/Roo)等任意 MCP 兼容客户端。

  5. 5导入文档源

    按 docs/guides/basic-usage.md 使用 Web UI 或 CLI,抓取网站、GitHub 仓库、本地文件夹或 zip 压缩包。

如何确认成功

在 MCP 客户端中发起一次文档查询,能返回来自官方源的结构化文档片段即表示接入成功。

常见问题

Q:支持哪些文档格式?

A:支持 PDF、Word、Excel、PowerPoint、OpenDocument、RTF、EPUB、Jupyter Notebook 等文档,以及 90 多种源码语言。

Q:可以接入哪些 AI 客户端?

A:任何兼容 MCP 协议的客户端都可以,README 点名了 Claude、Cline、Roo、VS Code、Cursor、Windsurf 等。

Q:代码会被上传到云端吗?

A:不会。项目完全运行在你自己的机器上,代码不会离开你的网络。

Q:必须用付费的嵌入服务吗?

A:不一定。README 的嵌入模型文档同时列出了 OpenAI、Ollama、Gemini 等提供方,Ollama 可本地运行。

注意事项

  • README 的 Quick Start 只给了文档链接,没有可直接复制的安装命令,请以官方 docs 目录下的说明为准。
  • 项目是 Context7、Nia 和 Ref.Tools 的开源替代方案,可免费自建。
  • 支持索引网站、GitHub 仓库、本地文件夹和 zip 压缩包等多种来源。
  • 本教程基于 README 节选整理,具体命令和配置项请核对官方文档。

核心亮点

  • 实时同步官方文档,确保AI引用最新API,减少因文档过期导致的错误
  • 支持语义搜索,能精准定位文档片段,提升回答相关性
  • 完全开源且免费,可自托管,数据隐私可控,替代商业服务

不足之处

  • 文档源覆盖范围有限,需用户自行添加或依赖社区贡献
  • 配置和部署需要一定技术门槛,对非开发者不够友好

适用场景

  • AI编程助手集成,提升代码生成准确性
  • 企业内部知识库接入,供AI查询私有技术文档
  • 开发者工具链中,为自动化脚本提供最新API参考

替代项目

Context7、Nia、Ref.Tools

项目介绍

docs-mcp-server 是智能体领域的开源项目,由 arabold 开发,2025 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(1,755)位列前 30%,在智能体分类中处于中上游。

近 42 天,它的 GitHub 星标从 1,640 增加到 1,755,净增 115。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。MIT许可证,完全免费,可自行部署使用。

它主要面向的使用场景是:AI编程助手集成,提升代码生成准确性。同类可对比的替代方案包括 Context7、Nia、Ref.Tools。

上一篇:react-agent

下一篇:rosa

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 195 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12