Deepwiki

Obtém conteúdo do deepwiki.com e converte em markdown legível por LLM.

GitHub
1.4k
Experimente este MCPPatrocinado

Documentação

Servidor MCP Deepwiki

⚠️ AVISO IMPORTANTE: Este servidor atualmente não está funcionando, pois o DeepWiki bloqueou a possibilidade de raspagem. Recomendamos usar o servidor MCP oficial do DeepWiki em https://docs.devin.ai/work-with-devin/deepwiki-mcp por enquanto.

Este é um Servidor MCP Deepwiki não oficial

Ele recebe uma URL do Deepwiki via MCP, rastreia todas as páginas relevantes, converte-as para Markdown e retorna um documento único ou uma lista por página.

Recursos

  • 🔒 Segurança de Domínio: Processa apenas URLs de deepwiki.com
  • 🧹 Sanitização de HTML: Remove cabeçalhos, rodapés, navegação, scripts e anúncios
  • 🔗 Reescrita de Links: Ajusta links para funcionarem em Markdown
  • 📄 Múltiplos Formatos de Saída: Obtenha um documento único ou páginas estruturadas
  • 🚀 Desempenho: Rastreamento rápido com concorrência e profundidade ajustáveis
  • NLP: Serve para buscar apenas o nome da biblioteca

Uso

Prompts que você pode usar:

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

Buscar documentação completa (Padrão)

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

Obter por formato abreviado

use deepwiki fetch tailwindlabs/tailwindcss

deepwiki fetch library

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

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

Cursor

Adicione isto ao arquivo .cursor/mcp.json.

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

Deepwiki Logo

Integração com Ferramenta MCP

O pacote registra uma ferramenta chamada deepwiki_fetch que você pode usar com qualquer cliente compatível com MCP:

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

Parâmetros

  • url (obrigatório): A URL inicial do repositório Deepwiki
  • mode (opcional): Modo de saída, "aggregate" para um único documento Markdown (padrão) ou "pages" para dados de página estruturados
  • maxDepth (opcional): Profundidade máxima de páginas a rastrear (padrão: 10)

Formato de Resposta

Resposta de Sucesso (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
}

Resposta de Sucesso (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
}

Resposta de Erro

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

Resposta de Sucesso 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 Progresso

Ao usar a ferramenta, você receberá eventos de progresso durante o rastreamento:

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)

Desenvolvimento Local - Instalação

Uso Local

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

A partir do Código-Fonte

# 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

Chamadas Diretas à API

Para transporte HTTP, você pode fazer chamadas diretas à 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"
    }
  }'

Configuração

Variáveis de Ambiente

  • DEEPWIKI_MAX_CONCURRENCY: Máximo de requisições concorrentes (padrão: 5)
  • DEEPWIKI_REQUEST_TIMEOUT: Tempo limite de requisição em milissegundos (padrão: 30000)
  • DEEPWIKI_MAX_RETRIES: Número máximo de tentativas para requisições com falha (padrão: 3)
  • DEEPWIKI_RETRY_DELAY: Atraso base para retry backoff em milissegundos (padrão: 250)

Para configurar, crie um arquivo .env na raiz do projeto:

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

Implantação com Docker (Não Testado)

Construa e execute a imagem 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

Desenvolvimento

# 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

Solução de Problemas

Problemas Comuns

  1. Permissão Negada: Se você receber erros EACCES ao executar a CLI, certifique-se de tornar o binário executável:

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

  2. Conexão Recusada: Certifique-se de que a porta esteja disponível e não bloqueada por um firewall:

    # Check if port is in use
lsof -i :3000

  3. Erros de Tempo Limite: Para repositórios grandes, considere aumentar o tempo limite e a concorrência:

    DEEPWIKI_REQUEST_TIMEOUT=60000 DEEPWIKI_MAX_CONCURRENCY=10 npx mcp-deepwiki

Contribuindo

Aceitamos contribuições! Consulte CONTRIBUTING.md para detalhes.

Licença

MIT

Links

Cursos

Veja meus outros projetos:

  • AI Prompts - Prompts de IA selecionados para Cursor AI, Cline, Windsurf e Github Copilot
  • codefetch - Transforme código em Markdown para LLMs com um simples comando de terminal
  • aidex Uma ferramenta CLI que fornece informações detalhadas sobre modelos de linguagem de IA, ajudando desenvolvedores a escolher o modelo certo para suas necessidades.# tool-starter