Deepwiki MCP-Server

Dies ist ein inoffizieller Deepwiki MCP-Server

Es nimmt eine Deepwiki-URL über MCP, crawlt alle relevanten Seiten, konvertiert sie in Markdown und gibt entweder ein Dokument oder eine Liste pro Seite zurück.

Merkmale

• 🔒 Domänensicherheit : Verarbeitet nur URLs von deepwiki.com

• 🧹 HTML-Bereinigung : Entfernt Kopf- und Fußzeilen, Navigation, Skripte und Anzeigen

• 🔗 Link-Neuschreibung : Passt Links an, damit sie in Markdown funktionieren

• 📄 Mehrere Ausgabeformate : Erhalten Sie ein Dokument oder strukturierte Seiten

• 🚀 Leistung : Schnelles Crawlen mit einstellbarer Parallelität und Tiefe

• NLP : Es wird nur nach dem Bibliotheksnamen gesucht

Related MCP server: Markdown-To-Notion

Verwendung

Eingabeaufforderungen, die Sie verwenden können:

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

Vollständige Dokumentation abrufen (Standard)

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

Einzelne Seite

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

Erhalten Sie per Kurzform

use deepwiki fetch tailwindlabs/tailwindcss

deepwiki fetch library

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

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

Cursor

Fügen Sie dies der .cursor/mcp.json hinzu.

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

MCP-Tool-Integration

Das Paket registriert ein Tool namens deepwiki_fetch , das Sie mit jedem MCP-kompatiblen Client verwenden können:

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

Parameter

• url (erforderlich): Die Start-URL des Deepwiki-Repositorys

• mode (optional): Ausgabemodus, entweder „aggregate“ für ein einzelnes Markdown-Dokument (Standard) oder „pages“ für strukturierte Seitendaten

• maxDepth (optional): Maximale Tiefe der zu crawlenden Seiten (Standard: 10)

Antwortformat

Erfolgsantwort (Aggregatmodus)

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

Erfolgsantwort (Seitenmodus)

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

Fehlerantwort

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

Teilweise Erfolgsantwort

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

Fortschrittsereignisse

Wenn Sie das Tool verwenden, erhalten Sie während des Crawlens Fortschrittsereignisse:

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)

Lokale Entwicklung - Installation

Lokale Nutzung

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

Aus der Quelle

# 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

Direkte API-Aufrufe

Für den HTTP-Transport können Sie direkte API-Aufrufe tätigen:

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

Konfiguration

Umgebungsvariablen

• DEEPWIKI_MAX_CONCURRENCY : Maximale Anzahl gleichzeitiger Anfragen (Standard: 5)

• DEEPWIKI_REQUEST_TIMEOUT : Anforderungs-Timeout in Millisekunden (Standard: 30000)

• DEEPWIKI_MAX_RETRIES : Maximale Wiederholungsversuche für fehlgeschlagene Anfragen (Standard: 3)

• DEEPWIKI_RETRY_DELAY : Basisverzögerung für Wiederholungs-Backoff in Millisekunden (Standard: 250)

Um diese zu konfigurieren, erstellen Sie eine .env Datei im Projektstammverzeichnis:

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

Docker-Bereitstellung (ungetestet)

Erstellen und führen Sie das Docker-Image aus:

# 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

Entwicklung

# 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

Fehlerbehebung

Häufige Probleme

1. Berechtigung verweigert : Wenn beim Ausführen der CLI EACCES-Fehler auftreten, stellen Sie sicher, dass die Binärdatei ausführbar ist:

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

2. Verbindung abgelehnt : Stellen Sie sicher, dass der Port verfügbar ist und nicht durch eine Firewall blockiert wird:

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

3. Timeout-Fehler : Erwägen Sie bei großen Repositories eine Erhöhung des Timeouts und der Parallelität:

   DEEPWIKI_REQUEST_TIMEOUT=60000 DEEPWIKI_MAX_CONCURRENCY=10 npx mcp-deepwiki

Beitragen

Wir freuen uns über Beiträge! Weitere Informationen finden Sie unter CONTRIBUTING.md .

Lizenz

MIT

Links

• X/Twitter: @kregenrek

• Bluesky: @kevinkern.dev

Kurse

• Cursor-KI lernen: Ultimativer Cursor-Kurs

• Lernen Sie, Software mit KI zu erstellen: instructa.ai

Sehen Sie sich meine anderen Projekte an:

• KI-Eingabeaufforderungen – Kuratierte KI-Eingabeaufforderungen für Cursor AI, Cline, Windsurf und Github Copilot

• Codefetch – Wandeln Sie Code mit einem einfachen Terminalbefehl in Markdown für LLMs um

• aidex Ein CLI-Tool, das detaillierte Informationen zu KI-Sprachmodellen bereitstellt und Entwicklern hilft, das richtige Modell für ihre Anforderungen auszuwählen.# tool-starter