Deepwiki MCP Server
Сервер Deepwiki MCP
Это неофициальный сервер Deepwiki MCP
Он принимает URL-адрес Deepwiki через MCP, сканирует все соответствующие страницы, преобразует их в Markdown и возвращает либо один документ, либо список страниц.
Функции
🔒 Безопасность домена : обрабатывает только URL-адреса из deepwiki.com
🧹 Очистка HTML : удаление заголовков, нижних колонтитулов, навигации, скриптов и рекламы.
🔗 Переписывание ссылок : настраивает ссылки для работы в Markdown
📄 Несколько форматов вывода : получите один документ или структурированные страницы
🚀 Производительность : быстрое сканирование с регулируемой конкуренцией и глубиной
НЛП : Это поиск только по названию библиотеки.
Related MCP server: Crawl4AI MCP Server
Использование
Подсказки, которые вы можете использовать:
deepwiki fetch how can i use gpt-image-1 with "vercel ai" sdkdeepwiki fetch how can i create new blocks in shadcn?deepwiki fetch i want to understand how X worksПолучить полную документацию (по умолчанию)
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/tailwindcssdeepwiki fetch library
deepwiki fetch url
deepwiki fetch <name>/<repo>
deepwiki multiple pages ...
deepwiki single page url ...Курсор
Добавьте это в файл .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(обязательно): начальный URL-адрес репозитория Deepwikimode(необязательно): режим вывода, либо «агрегированный» для одного документа Markdown (по умолчанию), либо «страницы» для структурированных данных страницы.maxDepth(необязательно): максимальная глубина сканирования страниц (по умолчанию: 10)
Формат ответа
Успешный ответ (агрегированный режим)
{
"status": "ok",
"data": "# Page Title\n\nPage content...\n\n---\n\n# Another Page\n\nMore content...",
"totalPages": 5,
"totalBytes": 25000,
"elapsedMs": 1200
}Успешный ответ (режим страниц)
{
"status": "ok",
"data": [
{
"path": "index",
"markdown": "# Home Page\n\nWelcome to the repository."
},
{
"path": "section/page1",
"markdown": "# First Page\n\nThis is the first page content."
}
],
"totalPages": 2,
"totalBytes": 12000,
"elapsedMs": 800
}Ошибка ответа
{
"status": "error",
"code": "DOMAIN_NOT_ALLOWED",
"message": "Only deepwiki.com domains are allowed"
}Частичный успешный ответ
{
"status": "partial",
"data": "# Page Title\n\nPage content...",
"errors": [
{
"url": "https://deepwiki.com/user/repo/page2",
"reason": "HTTP error: 404"
}
],
"totalPages": 1,
"totalBytes": 5000,
"elapsedMs": 950
}Прогресс События
При использовании инструмента вы будете получать события прогресса во время сканирования:
Fetched https://deepwiki.com/user/repo: 12500 bytes in 450ms (status: 200)
Fetched https://deepwiki.com/user/repo/page1: 8750 bytes in 320ms (status: 200)
Fetched https://deepwiki.com/user/repo/page2: 6200 bytes in 280ms (status: 200)Местное развитие - Установка
Местное использование
{
"mcpServers": {
"mcp-deepwiki": {
"command": "node",
"args": ["./bin/cli.mjs"]
}
}
}Из источника
# Clone the repository
git clone https://github.com/regenrek/deepwiki-mcp.git
cd deepwiki-mcp
# Install dependencies
npm install
# Build the package
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:
# Build the image
docker build -t mcp-deepwiki .
# Run with stdio transport (for development)
docker run -it --rm mcp-deepwiki
# Run with HTTP transport (for production)
docker run -d -p 3000:3000 mcp-deepwiki --http --port 3000
# Run with environment variables
docker run -d -p 3000:3000 \
-e DEEPWIKI_MAX_CONCURRENCY=10 \
-e DEEPWIKI_REQUEST_TIMEOUT=60000 \
mcp-deepwiki --http --port 3000Разработка
# Install dependencies
pnpm install
# Run in development mode with stdio
pnpm run dev-stdio
# Run tests
pnpm test
# Run linter
pnpm run lint
# Build the package
pnpm run buildПоиск неисправностей
Распространенные проблемы
Отказано в доступе : если при запуске CLI возникают ошибки EACCES, обязательно сделайте двоичный файл исполняемым:
chmod +x ./node_modules/.bin/mcp-deepwikiВ подключении отказано : убедитесь, что порт доступен и не заблокирован брандмауэром:
# Check if port is in use lsof -i :3000Ошибки тайм-аута : для больших репозиториев рассмотрите возможность увеличения тайм-аута и параллелизма:
DEEPWIKI_REQUEST_TIMEOUT=60000 DEEPWIKI_MAX_CONCURRENCY=10 npx mcp-deepwiki
Внося вклад
Мы приветствуем ваши вклады! Подробности смотрите на CONTRIBUTING.md .
Лицензия
Массачусетский технологический институт
Ссылки
X/Твиттер: @kregenrek
Bluesky: @kevinkern.dev
Курсы
Изучите искусственный интеллект курсора: окончательный курс по курсору
Научитесь создавать программное обеспечение с помощью ИИ: instructa.ai
Смотрите мои другие проекты:
Подсказки ИИ — тщательно подобранные подсказки ИИ для Cursor AI, Cline, Windsurf и Github Copilot
codefetch — преобразуйте код в Markdown для LLM с помощью одной простой команды терминала
aidex Инструмент CLI, предоставляющий подробную информацию о языковых моделях ИИ, помогающий разработчикам выбрать правильную модель для своих нужд.# tool-starter
Available Tools
1 tooldeepwiki_fetchC
Fetch a deepwiki.com repo and return Markdown
Inputs: url (required), maxDepth, mode, verbose.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined as fetching a Deepwiki repo and returning Markdown, making it impossible to confuse with any other tool.
The single tool name follows a consistent verb_noun pattern (deepwiki_fetch), and with only one tool, there is no inconsistency to evaluate. The naming is clear and adheres to a predictable structure.
A single tool is generally too few for a server's purpose, as it limits functionality and may indicate an incomplete surface. For a Deepwiki server, one tool feels thin and under-scoped, lacking operations like search, update, or list repos that might be expected.
The server is severely incomplete for interacting with Deepwiki repos. It only provides a fetch operation, missing essential CRUD/lifecycle coverage such as creating, updating, deleting, or searching repos, which are likely needed for full agent workflows in this domain.
Maintenance
Related MCP Connectors
MCP server for opencode documentation, generated by doc2mcp.
Web scraping MCP server: any URL to Markdown or JSON, with JavaScript rendering and batch jobs.
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
MCP server for innovationlab documentation, generated by doc2mcp.
Related MCP Servers
- AlicenseCqualityDmaintenanceAn MCP server that converts Markdown content to Notion API-compatible formats, suitable for content management and development integration.11Apache 2.0
- FlicenseNot gradedqualityDmaintenanceA locally-hosted MCP server that provides AI assistants with advanced web crawling capabilities, including structured data extraction, deep site crawling, and page screenshots. It enables users to convert single or multiple URLs into clean Markdown content for processing by LLMs without requiring external API keys for basic features.-
- AlicenseAqualityDmaintenanceMCP server that allows AI agents to fetch and process llms.txt documentation from various sources. Fetch documentation from any HTTPS URL and automatically convert HTML content to readable markdown.24 npm2MIT
- AlicenseNot gradedqualityDmaintenanceA documentation MCP server that crawls websites and Git repositories, stores them as Markdown, and provides tools to search and retrieve documentation for local LLMs and AI agents.Apache 2.0