Deepwiki MCP 服务器

⚠️ 重要通知：由于 DeepWiki 已经切断了爬取其内容的可能性，此服务器目前无法正常工作。我们建议暂时使用官方的 DeepWiki MCP 服务器，地址为 https://docs.devin.ai/work-with-devin/deepwiki-mcp。

这是一个 非官方的 DeepWiki MCP 服务器

它通过 MCP 接收 DeepWiki 的 URL，抓取所有相关页面，将其转换为 Markdown 格式，并以单个文档或按页面分组的形式返回。

功能特性

• 🔒 域名安全：仅处理来自 deepwiki.com 的 URL
• 🧹 HTML 净化：移除页眉、页脚、导航栏、脚本和广告
• 🔗 链接重写：调整链接使其在 Markdown 中可用
• 📄 多种输出格式：可获取单个文档或结构化的页面集合
• 🚀 性能优化：快速爬取，支持自定义并发数和爬取深度
• NLP：仅针对库名称进行搜索

使用方法

您可以使用的提示命令如下：

deepwiki fetch 如何将 gpt-image-1 与 "vercel ai" SDK 配合使用

deepwiki fetch 如何在 shadcn 中创建新组件？

deepwiki fetch 我想了解 X 是如何工作的

获取完整文档（默认）

use deepwiki https://deepwiki.com/shadcn-ui/ui
use deepwiki multiple pages https://deepwiki.com/shadcn-ui/ui

单个页面

use deepwiki fetch single page https://deepwiki.com/tailwindlabs/tailwindcss/2.2-theme-system

通过简短形式获取

use deepwiki fetch tailwindlabs/tailwindcss

deepwiki fetch library

deepwiki fetch url
deepwiki fetch <name>/<repo>

deepwiki multiple pages ...
deepwiki single page url ...

Cursor 集成

将以下内容添加到 .cursor/mcp.json 文件中：

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

MCP 工具集成

该包注册了一个名为 deepwiki_fetch 的工具，您可以在任何兼容 MCP 的客户端中使用：

{
  "action": "deepwiki_fetch",
  "params": {
    "url": "https://deepwiki.com/user/repo",
    "mode": "aggregate",
    "maxDepth": "1"
  }
}

参数说明

• url（必填）：DeepWiki 仓库的起始 URL
• mode（可选）：输出模式，aggregate 表示生成一个单一的 Markdown 文档（默认），pages 表示返回结构化的页面数据
• maxDepth（可选）：最大爬取深度（默认值为 10）

响应格式

成功响应（聚合模式）

{
  "status": "ok",
  "data": "# 页面标题\n\n页面内容...\n\n---\n\n# 另一页\n\n更多内容...",
  "totalPages": 5,
  "totalBytes": 25000,
  "elapsedMs": 1200
}

成功响应（页面模式）

{
  "status": "ok",
  "data": [
    {
      "path": "index",
      "markdown": "# 首页\n\n欢迎来到该仓库。"
    },
    {
      "path": "section/page1",
      "markdown": "# 第一页\n\n这是第一页的内容。"
    }
  ],
  "totalPages": 2,
  "totalBytes": 12000,
  "elapsedMs": 800
}

错误响应

{
  "status": "error",
  "code": "DOMAIN_NOT_ALLOWED",
  "message": "仅允许 deepwiki.com 域名"
}

部分成功响应

{
  "status": "partial",
  "data": "# 页面标题\n\n页面内容...",
  "errors": [
    {
      "url": "https://deepwiki.com/user/repo/page2",
      "reason": "HTTP 错误：404"
    }
  ],
  "totalPages": 1,
  "totalBytes": 5000,
  "elapsedMs": 950
}

进度事件

使用该工具时，您会在爬取过程中收到进度事件：

已抓取 https://deepwiki.com/user/repo：450 毫秒内抓取 12500 字节（状态：200）
已抓取 https://deepwiki.com/user/repo/page1：320 毫秒内抓取 8750 字节（状态：200）
已抓取 https://deepwiki.com/user/repo/page2：280 毫秒内抓取 6200 字节（状态：200）

本地开发 - 安装

本地使用

{
  "mcpServers": {
    "mcp-deepwiki": {
      "command": "node",
      "args": ["./bin/cli.mjs"]
    }
  }
}

从源码安装

# 克隆仓库
git clone https://github.com/regenrek/deepwiki-mcp.git
cd deepwiki-mcp

# 安装依赖
npm install

# 构建项目
npm run build

直接 API 调用

对于 HTTP 传输，您可以直接调用 API：

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "id": "req-1",
    "action": "deepwiki_fetch",
    "params": {
      "url": "https://deepwiki.com/user/repo",
      "mode": "aggregate"
    }
  }'

配置

环境变量

• DEEPWIKI_MAX_CONCURRENCY：最大并发请求数（默认值：5）
• DEEPWIKI_REQUEST_TIMEOUT：请求超时时间，单位为毫秒（默认值：30000）
• DEEPWIKI_MAX_RETRIES：失败请求的最大重试次数（默认值：3）
• DEEPWIKI_RETRY_DELAY：重试退避的基础延迟时间，单位为毫秒（默认值：250）

要配置这些变量，请在项目根目录下创建一个 .env 文件：

DEEPWIKI_MAX_CONCURRENCY=10
DEEPWIKI_REQUEST_TIMEOUT=60000
DEEPWIKI_MAX_RETRIES=5
DEEPWIKI_RETRY_DELAY=500

Docker 部署（未测试）

构建并运行 Docker 镜像：

# 构建镜像
docker build -t mcp-deepwiki .

# 使用 stdio 传输（用于开发）
docker run -it --rm mcp-deepwiki

# 使用 HTTP 传输（用于生产）
docker run -d -p 3000:3000 mcp-deepwiki --http --port 3000

# 使用环境变量运行
docker run -d -p 3000:3000 \
  -e DEEPWIKI_MAX_CONCURRENCY=10 \
  -e DEEPWIKI_REQUEST_TIMEOUT=60000 \
  mcp-deepwiki --http --port 3000

开发

# 安装依赖
pnpm install

# 在开发模式下使用 stdio 运行
pnpm run dev-stdio

# 运行测试
pnpm test

# 运行代码检查
pnpm run lint

# 构建项目
pnpm run build

故障排除

常见问题

1. 权限不足：如果在运行 CLI 时出现 EACCES 错误，请确保将二进制文件设置为可执行：

   chmod +x ./node_modules/.bin/mcp-deepwiki
   

2. 连接被拒绝：请确保端口可用且未被防火墙阻止：

   # 检查端口是否被占用
   lsof -i :3000
   

3. 超时错误：对于大型仓库，可以考虑增加超时时间和并发数：

   DEEPWIKI_REQUEST_TIMEOUT=60000 DEEPWIKI_MAX_CONCURRENCY=10 npx mcp-deepwiki
   

贡献

我们欢迎您的贡献！详细信息请参阅 CONTRIBUTING.md。

许可证

MIT

链接

• X/Twitter：@kregenrek
• Bluesky：@kevinkern.dev

课程

• 学习 Cursor AI：终极 Cursor 课程
• 学习如何用 AI 构建软件：instructa.ai

查看我的其他项目：

• AI Prompts - 为 Cursor AI、Cline、Windsurf 和 Github Copilot 精选的 AI 提示词
• codefetch - 通过一条简单的终端命令，将代码转换为适用于大语言模型的 Markdown 格式
• aidex 一个 CLI 工具，提供关于 AI 语言模型的详细信息，帮助开发者根据需求选择合适的模型。# 工具入门

deepwiki-mcp 快速上手指南

⚠️ 重要提示：由于 DeepWiki 官方已禁止爬虫抓取，本非官方服务器目前无法正常工作。建议暂时使用 Devin 官方提供的 MCP 服务器：https://docs.devin.ai/work-with-devin/deepwiki-mcp。以下内容仅供技术参考或本地开发调试使用。

环境准备

• 系统要求：支持 Node.js 的操作系统（Windows / macOS / Linux）
• 前置依赖：
  • Node.js (推荐 v18 或更高版本)
  • npm 或 pnpm 包管理器
  • 可选：Docker（如需容器化部署）

安装步骤

方式一：通过 Cursor 集成（推荐）

在项目的 .cursor/mcp.json 文件中添加以下配置，Cursor 将自动通过 npx 运行最新版本的工具：

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

方式二：本地源码安装

如果你需要自定义配置或进行开发，可以从源码安装：

# 克隆仓库
git clone https://github.com/regenrek/deepwiki-mcp.git
cd deepwiki-mcp

# 安装依赖
npm install

# 构建项目
npm run build

配置本地运行（修改 .cursor/mcp.json 或对应配置文件）：

{
  "mcpServers": {
    "mcp-deepwiki": {
      "command": "node",
      "args": ["./bin/cli.mjs"]
    }
  }
}

方式三：Docker 部署

# 构建镜像
docker build -t mcp-deepwiki .

# 运行（HTTP 模式）
docker run -d -p 3000:3000 mcp-deepwiki --http --port 3000

基本使用

安装完成后，你可以在支持 MCP 的客户端（如 Cursor）中直接使用自然语言指令或特定命令来获取 DeepWiki 文档。

1. 自然语言查询（推荐）

直接在对话框中输入以下格式的指令，工具会自动解析并抓取相关内容：

deepwiki fetch how can i use gpt-image-1 with "vercel ai" sdk

deepwiki fetch how can i create new blocks in shadcn?

2. 指定 URL 抓取完整文档

获取整个仓库的文档并合并为一个 Markdown 文件：

use deepwiki https://deepwiki.com/shadcn-ui/ui

3. 指定仓库简写

通过 作者/仓库名 的形式快速抓取：

deepwiki fetch tailwindlabs/tailwindcss

4. 高级参数调用（API 模式）

如果你需要通过代码或 HTTP 直接调用，可以使用以下 JSON 结构：

{
  "action": "deepwiki_fetch",
  "params": {
    "url": "https://deepwiki.com/user/repo",
    "mode": "aggregate",
    "maxDepth": "1"
  }
}

参数说明：

• url: 必填，DeepWiki 仓库起始地址。
• mode: 选填，aggregate（合并为单文档，默认）或 pages（返回分页结构）。
• maxDepth: 选填，最大爬取深度，默认为 10。

5. 环境变量配置（可选）

在项目根目录创建 .env 文件以调整并发和超时设置，优化大仓库抓取性能：

DEEPWIKI_MAX_CONCURRENCY=10
DEEPWIKI_REQUEST_TIMEOUT=60000
DEEPWIKI_MAX_RETRIES=5
DEEPWIKI_RETRY_DELAY=500