Deepwiki MCP Server

什么是 DeepWiki MCP Server？

这个 DeepWiki MCP 服务器是一个非官方的社区工具（regenrek 开发的 mcp-deepwiki），它会爬取 deepwiki.com 页面，并以 Markdown 形式返回到你的编辑器中。其 README 表示，由于 DeepWiki 已屏蔽抓取，它目前已无法使用，并建议改用官方 DeepWiki MCP 服务器。

DeepWiki 会为 GitHub 仓库生成文档 wiki。官方 DeepWiki MCP 服务器由 Devin 运营，是一个免费的远程服务器，地址为 https://mcp.deepwiki.com/mcp，访问公开仓库无需认证。如果你搜索“deepwiki mcp”是为了给 Cursor 或 Claude 提供某个仓库的上下文，应该安装的是官方服务器。本页对两者都有介绍，并做了明确区分。

如何使用 DeepWiki MCP Server？

推荐：官方 DeepWiki MCP 服务器

访问公开仓库无需安装、API 密钥或账号。使用 Streamable HTTP 端点 https://mcp.deepwiki.com/mcp。SSE 端点 https://mcp.deepwiki.com/sse 仍然存在，但正在被弃用。

Claude Code

claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp

Cursor

在 .cursor/mcp.json 中添加（同样的 url 格式也适用于其他使用该字段的客户端）：

{
  "mcpServers": {
    "deepwiki": {
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

Claude Desktop

通过 Claude 的自定义连接器设置，将 https://mcp.deepwiki.com/mcp 添加为远程服务器。Devin 的文档没有提供配置文件，而是链接到 Anthropic 关于连接远程 MCP 服务器的指南。

对于私有仓库，Devin 的文档指向另一个 Devin MCP 服务器，它需要 Devin 账号和 API 密钥。

本社区服务器（mcp-deepwiki）

该项目原本在 .cursor/mcp.json 中的 Cursor 配置如下：

{
  "mcpServers": {
    "mcp-deepwiki": {
      "command": "npx",
      "args": ["-y", "mcp-deepwiki@latest"]
    }
  }
}

也可以从源码构建：git clone https://github.com/regenrek/deepwiki-mcp.git、npm install，再执行 npm run build。请做好抓取失败的准备：根据 README 的公告，DeepWiki 已切断这个服务器所依赖的抓取途径。

DeepWiki MCP Server 的主要功能

以下是社区服务器 README 中列出的设计功能：

• 域名安全：只处理来自 deepwiki.com 的 URL
• HTML 清理：去除页眉、页脚、导航、脚本和广告
• 链接重写，使链接在 Markdown 中可用
• 两种输出模式：一个聚合文档，或按页面划分的结构化数据
• 可通过环境变量调整爬取并发数、深度、超时和重试
• 爬取时提供进度事件，支持 stdio 或 HTTP（--http）传输

相比之下，官方服务器直接读取 DeepWiki 生成的 wiki，并且可以回答关于仓库的问题。

DeepWiki MCP Server 工具

社区服务器注册了一个工具：deepwiki_fetch。它接收 url（必填；起始的 deepwiki.com URL）、mode（默认 aggregate 生成单个 Markdown 文档，或 pages 返回结构化页面）以及 maxDepth（默认 10）。返回结果为 ok、partial 或 error，并附带页面数和耗时。

官方 DeepWiki MCP 服务器提供三个不同的工具：

• read_wiki_structure：列出某个 GitHub 仓库的文档主题
• read_wiki_contents：返回关于该仓库的文档内容
• ask_question：针对仓库提问，获得基于上下文的 AI 回答

DeepWiki MCP Server 的使用场景

以下提示词适用于官方服务器，也就是目前可用的那个：

• 学习不熟悉的库：“Using DeepWiki, explain how routing works in vercel/next.js.”
• 定位文档中的相关部分：“List the wiki topics for shadcn-ui/ui, then read the one about theming.”
• 回答具体问题：“Ask DeepWiki how to create a new block in shadcn-ui/ui.”
• 贡献代码前了解架构：“Summarize how tailwindlabs/tailwindcss structures its theme system.”
• 为编程智能体提供依赖库的最新上下文，而不必把文档粘贴进对话。

DeepWiki MCP Server 与替代方案对比

官方 DeepWiki MCP 服务器是本页面所收录服务器的直接替代品：它由 DeepWiki 的运营方维护，无需抓取，还提供 ask_question。如果需要来自软件包源码而非 DeepWiki 的库文档，Context7 MCP 可以向编程智能体提供特定版本的文档。如果要读取项目的实际源码，GitHub MCP Server 能让智能体访问仓库、issue 和 pull request。

DeepWiki MCP Server 常见问题排查

• deepwiki_fetch 返回错误或空结果： 这正是 README 公告中描述的已知故障。请改用官方服务器 https://mcp.deepwiki.com/mcp。
• 出现 DOMAIN_NOT_ALLOWED 错误： 社区服务器只接受 deepwiki.com 的 URL。
• 大型仓库超时： 调高 DEEPWIKI_REQUEST_TIMEOUT 和 DEEPWIKI_MAX_CONCURRENCY，例如 DEEPWIKI_REQUEST_TIMEOUT=60000 DEEPWIKI_MAX_CONCURRENCY=10 npx mcp-deepwiki。
• EACCES 权限被拒绝： 用 chmod +x ./node_modules/.bin/mcp-deepwiki 赋予二进制文件可执行权限。
• 官方服务器在 Devin Desktop 中被忽略： 该客户端需要使用 serverUrl 字段；字段名写错会导致服务器被静默忽略。