Skip to main content
Glama
Deepwiki MCP Server
by regenrek

Servidor MCP de Deepwiki

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: Crawl4AI MCP Server

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

  1. 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
  2. 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
  3. 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

Cursos

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

Available Tools

1 tool
deepwiki_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

    B3.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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