Сервер Deepwiki MCP

Name: Deepwiki MCP Server
Author: regenrek

Это неофициальный сервер Deepwiki MCP

Он принимает URL-адрес Deepwiki через MCP, сканирует все соответствующие страницы, преобразует их в Markdown и возвращает либо один документ, либо список страниц.

Функции

🔒 Безопасность домена : обрабатывает только URL-адреса из deepwiki.com
🧹 Очистка HTML : удаление заголовков, нижних колонтитулов, навигации, скриптов и рекламы.
🔗 Переписывание ссылок : настраивает ссылки для работы в Markdown
📄 Несколько форматов вывода : получите один документ или структурированные страницы
🚀 Производительность : быстрое сканирование с регулируемой конкуренцией и глубиной
НЛП : Это поиск только по названию библиотеки.

Related MCP server: MCP NPX Fetch

Использование

Подсказки, которые вы можете использовать:

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

deepwiki 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/tailwindcss

deepwiki 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-адрес репозитория Deepwiki
mode (необязательно): режим вывода, либо «агрегированный» для одного документа 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

Deepwiki MCP Server