deepwiki-mcp

To run the server from source for local development:

1. Clone the repository: git clone https://github.com/regenrek/deepwiki-mcp.git
2. Navigate to the directory: cd deepwiki-mcp
3. Install dependencies: npm install
4. Build the package: npm run build

To use unbuild as your build system, follow these steps:

1. Create your source entry point (e.g., src/index.ts).
2. Update your package.json to include build scripts and export definitions. unbuild automatically infers configuration from package.json fields.
3. Run the build using npx unbuild.

Required package.json structure:

{
  "type": "module",
  "scripts": {
    "build": "unbuild",
    "prepack": "unbuild"
  },
  "exports": {
    ".": {
      "import": "./dist/index.mjs",
      "require": "./dist/index.cjs"
    }
  },
  "main": "./dist/index.cjs",
  "types": "./dist/index.d.ts",
  "files": ["dist"]
}

To use the Deepwiki MCP server in Cursor, add the following configuration to your .cursor/mcp.json file. This uses npx to run the latest version of the mcp-deepwiki package.

⚠️ IMPORTANT NOTICE: This server is currently not working since DeepWiki has cut off the possibility to scrape it. The maintainer recommends using the official DeepWiki MCP server at https://docs.devin.ai/work-with-devin/deepwiki-mcp.

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

You can run the server in a container. Use stdio transport for development or --http for production-ready HTTP transport.

Build the image:

docker build -t mcp-deepwiki .

Run with stdio (Development):

docker run -it --rm mcp-deepwiki

Run with HTTP (Production):

docker run -d -p 3000:3000 mcp-deepwiki --http --port 3000

Run with HTTP and Environment Variables:

docker run -d -p 3000:3000 \
  -e DEEPWIKI_MAX_CONCURRENCY=10 \
  -e DEEPWIKI_REQUEST_TIMEOUT=60000 \
  mcp-deepwiki --http --port 3000

You can tune the crawler's performance and reliability by setting the following environment variables in a .env file in the project root:

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

Permission Denied

If you encounter EACCES errors when running the CLI, ensure the binary is executable:

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

Connection Refused

Verify if the port (default 3000) is available or blocked:

lsof -i :3000

Timeout Errors

For large repositories, increase the timeout and concurrency via environment variables:

DEEPWIKI_REQUEST_TIMEOUT=60000 DEEPWIKI_MAX_CONCURRENCY=10 npx mcp-deepwiki

To enable sourcemap generation during the build process, set the sourcemap option to true in your build.config.ts.

import { defineBuildConfig } from 'unbuild'

export default defineBuildConfig({
  sourcemap: true,
})

To support experimental decorators, configure the esbuild options within the rollup object in your build.config.ts to pass tsconfigRaw settings.

import { defineBuildConfig } from 'unbuild'

export default defineBuildConfig({
  rollup: {
    esbuild: {
      tsconfigRaw: {
        compilerOptions: {
          experimentalDecorators: true,
        },
      },
    },
  },
})

The package registers a tool named deepwiki_fetch that can be used with any MCP-compatible client. It crawls Deepwiki URLs, sanitizes the HTML, and returns content in Markdown format.

Parameters

• url (required): The starting URL of the Deepwiki repository.
• mode (optional): Output mode. Use aggregate (default) for a single Markdown document or pages for structured page data.
• maxDepth (optional): Maximum depth of pages to crawl (default: 10).

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