Servidor MCP de Deepwiki

Name: Deepwiki MCP Server
Author: regenrek

Este es un servidor MCP de Deepwiki no oficial

Toma una URL de Deepwiki a través de MCP, rastrea todas las páginas relevantes, las convierte a Markdown y devuelve un documento o una lista por página.

Características

🔒 Seguridad del dominio : solo procesa URL de deepwiki.com
🧹 Sanitización HTML : elimina encabezados, pies de página, navegación, scripts y anuncios
🔗 Reescritura de enlaces : ajusta los enlaces para que funcionen en Markdown
📄 Múltiples formatos de salida : obtenga un documento o páginas estructuradas
🚀 Rendimiento : rastreo rápido con simultaneidad y profundidad ajustables
PNL : Sirve para buscar solo el nombre de la biblioteca

Related MCP server: MCP NPX Fetch

Uso

Indicaciones que puedes utilizar:

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

Obtener documentación completa (predeterminado)

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

Página única

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

Obtener por formato corto

use deepwiki fetch tailwindlabs/tailwindcss

deepwiki fetch library deepwiki fetch url deepwiki fetch <name>/<repo> deepwiki multiple pages ... deepwiki single page url ...

Cursor

Agregue esto al archivo .cursor/mcp.json .

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

Logotipo de Deepwiki

Integración de herramientas MCP

El paquete registra una herramienta llamada deepwiki_fetch que puedes usar con cualquier cliente compatible con MCP:

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

Parámetros

url (obligatorio): La URL de inicio del repositorio de Deepwiki
mode (opcional): modo de salida, ya sea "agregado" para un solo documento Markdown (predeterminado) o "páginas" para datos de página estructurados
maxDepth (opcional): profundidad máxima de páginas a rastrear (predeterminado: 10)

Formato de respuesta

Respuesta de éxito (modo agregado)

{ "status": "ok", "data": "# Page Title\n\nPage content...\n\n---\n\n# Another Page\n\nMore content...", "totalPages": 5, "totalBytes": 25000, "elapsedMs": 1200 }

Respuesta de éxito (modo Páginas)

{ "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 }

Respuesta de error

{ "status": "error", "code": "DOMAIN_NOT_ALLOWED", "message": "Only deepwiki.com domains are allowed" }

Respuesta de éxito parcial

{ "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 }

Eventos de progreso

Al utilizar la herramienta, recibirá eventos de progreso durante el rastreo:

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)

Desarrollo Local - Instalación

Uso local

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

De la fuente

# 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

Llamadas directas a la API

Para el transporte HTTP, puedes realizar llamadas API directas:

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" } }'

Configuración

Variables de entorno

DEEPWIKI_MAX_CONCURRENCY : Máximo de solicitudes simultáneas (predeterminado: 5)
DEEPWIKI_REQUEST_TIMEOUT : Tiempo de espera de la solicitud en milisegundos (valor predeterminado: 30000)
DEEPWIKI_MAX_RETRIES : Máximo de intentos de reintento para solicitudes fallidas (valor predeterminado: 3)
DEEPWIKI_RETRY_DELAY : Retraso base para la retirada del reintento en milisegundos (valor predeterminado: 250)

Para configurarlos, cree un archivo .env en la raíz del proyecto:

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

Implementación de Docker (sin probar)

Construya y ejecute la imagen de 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

Desarrollo

# 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

Solución de problemas

Problemas comunes

Permiso denegado : si recibe errores EACCES al ejecutar la CLI, asegúrese de que el binario sea ejecutable:
chmod +x ./node_modules/.bin/mcp-deepwiki
Conexión rechazada : asegúrese de que el puerto esté disponible y no esté bloqueado por un firewall:
# Check if port is in use lsof -i :3000
Errores de tiempo de espera : para repositorios grandes, considere aumentar el tiempo de espera y la simultaneidad:
DEEPWIKI_REQUEST_TIMEOUT=60000 DEEPWIKI_MAX_CONCURRENCY=10 npx mcp-deepwiki

Contribuyendo

¡Agradecemos sus contribuciones! Para más detalles, consulte CONTRIBUTING.md .

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Campo de golf

X/Twitter: @kregenrek
Bluesky: @kevinkern.dev

Cursos

Aprende Cursor AI: Curso Definitivo de Cursor
Aprenda a crear software con IA: instructa.ai

Vea mis otros proyectos:

Avisos de IA : Avisos de IA seleccionados para Cursor AI, Cline, Windsurf y Github Copilot
codefetch : convierte código en Markdown para LLM con un simple comando de terminal
aidex Una herramienta CLI que proporciona información detallada sobre los modelos de lenguaje de IA, lo que ayuda a los desarrolladores a elegir el modelo adecuado para sus necesidades.# tool-starter

Deepwiki MCP Server