Deepwiki MCP Server for Windsurf: Setup & Config

What you can do with Deepwiki in Windsurf

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

• Evaluate the documented design for turning repository documentation into Markdown.
• Inspect the intended aggregate versus per-page documentation outputs.

Before you start: Deepwiki in Windsurf

• 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 Windsurf configuration

1. Choose Windsurf configuration scope

   For Deepwiki MCP Server, open macOS/Linux: ~/.codeium/windsurf/mcp_config.json Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json. Merge into mcpServers; remote endpoints use serverUrl.

2. Add Deepwiki MCP Server to Windsurf

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

3. Check Deepwiki MCP Server in Windsurf

   Deepwiki MCP Server: Refresh MCP in Windsurf settings and inspect Cascade’s tools.

{
  "mcpServers": {
    "deepwiki-mcp": {
      "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 Windsurf

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

deepwiki_fetch

After refreshing Deepwiki in Windsurf settings, check Cascade's tool list for deepwiki_fetch.

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

Deepwiki: full stored tool descriptions

Troubleshooting Deepwiki in Windsurf

• Check npx mcp-deepwiki@latest (Node.js/npm) on the machine running Windsurf's MCP integration for Deepwiki MCP Server; refresh MCP and inspect Cascade's tools.
• Check DEEPWIKI_MAX_CONCURRENCY, DEEPWIKI_MAX_RETRIES, DEEPWIKI_REQUEST_TIMEOUT, DEEPWIKI_RETRY_DELAY for Deepwiki MCP Server; do not bypass a Windsurf permission error with a broad administrator token.
• Deepwiki MCP Server uses stdio here: Windsurf 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 Windsurf troubleshooting lives in the /clients/windsurf guide.

Frequently asked questions