Deepwiki MCP Server for Claude Code: Setup & Config

What you can do with Deepwiki in Claude Code

Evaluate its Markdown crawler design, but use the official alternative while scraping remains blocked.

• Evaluate the documented design for turning repository documentation into Markdown.
• Assess an existing installation before migrating to the official DeepWiki service.

Before you start: Deepwiki in Claude Code

• Node.js and npx
• An MCP-compatible client

This is the README's Cursor launch configuration, not a remedy for blocked scraping. The README recommends the official DeepWiki MCP service because this implementation is currently nonfunctional.

Deepwiki Claude Code configuration

1. Choose Claude Code configuration scope

   For Deepwiki MCP Server, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

2. Add Deepwiki MCP Server to Claude Code

   Use the deepwiki-mcp entry below in mcpServers. Keep Deepwiki MCP Server's documented stdio connection fields and your other Claude Code entries.

3. Check Deepwiki MCP Server in Claude Code

   Deepwiki MCP Server: Inspect claude mcp list and /mcp status.

{
  "mcpServers": {
    "deepwiki-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-deepwiki@latest"
      ],
      "env": {
        "DEEPWIKI_MAX_CONCURRENCY": "<optional simultaneous request limit>",
        "DEEPWIKI_REQUEST_TIMEOUT": "<optional request timeout in milliseconds>",
        "DEEPWIKI_MAX_RETRIES": "<optional retry count>",
        "DEEPWIKI_RETRY_DELAY": "<optional retry-backoff base in milliseconds>"
      }
    }
  }
}

claude mcp add-json --scope project 'deepwiki-mcp' '{"type":"stdio","command":"npx","args":["-y","mcp-deepwiki@latest"],"env":{"DEEPWIKI_MAX_CONCURRENCY":"<optional simultaneous request limit>","DEEPWIKI_REQUEST_TIMEOUT":"<optional request timeout in milliseconds>","DEEPWIKI_MAX_RETRIES":"<optional retry count>","DEEPWIKI_RETRY_DELAY":"<optional retry-backoff base in milliseconds>"}}'

Deepwiki tools available to Claude Code

Deepwiki's stored tool list documents 1 tool; compare it with Claude Code's connected tool list, because the stored list is not a live check.

deepwiki_fetch

For Deepwiki's deepwiki_fetch, review the permission request and arguments in Claude Code before approval.

Designed to crawl DeepWiki documentation and return combined Markdown or per-page records.

Deepwiki: full stored tool descriptions

Troubleshooting Deepwiki in Claude Code

• If Deepwiki MCP Server fails to start, check npx mcp-deepwiki@latest (Node.js/npm), the working directory, and Claude Code's selected scope; inspect claude mcp list and /mcp.
• Deepwiki MCP Server: check DEEPWIKI_MAX_CONCURRENCY, DEEPWIKI_MAX_RETRIES, DEEPWIKI_REQUEST_TIMEOUT, DEEPWIKI_RETRY_DELAY; keep credentials out of shared .mcp.json.
• Deepwiki MCP Server uses stdio here: Claude Code must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: The README reports the server currently does not work because scraping is blocked.
• Known limitation: It is an unofficial integration.
• Known limitation: Docker deployment is documented as untested.
• General Claude Code troubleshooting lives in the /clients/claude-code guide.

Frequently asked questions