mcp-deepwiki

library0.0.10jsnpmunverified

Provides an MCP tool (version 0.0.10) to fetch content from deepwiki.com, crawl all related pages, sanitize HTML, convert to markdown, and return either a single aggregated document or structured page list. Useful for AI agents to read library documentation. Key differentiators: domain safety (only deepwiki.com), link rewriting, configurable concurrency/depth. Under active development.

documentation ai-ml

npm install mcp-deepwiki

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MCP-DEEPWIKI

mcp-deepwiki

documentationjavascriptv0.0.10

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import mcpServer from 'mcp-deepwiki'

✗ const mcpServer = require('mcp-deepwiki')

Package is ESM-only (uses .mjs). No default export; intended to be used via CLI/MCP client.

deepwiki_fetch

✓ No direct JS import; the tool registers via MCP protocol. Use MCP client to call 'deepwiki_fetch'.

✗ import { deepwiki_fetch } from 'mcp-deepwiki'

The tool is not exported as a JS function; it's a registered MCP tool.

cli

✓ npx mcp-deepwiki@latest

✗ node node_modules/.bin/mcp-deepwiki

Recommended to run via npx. The package exposes a bin at ./bin/cli.mjs.

Configure MCP server in Cursor and fetch deepwiki documentation as markdown.

// In .cursor/mcp.json: { "mcpServers": { "mcp-deepwiki": { "command": "npx", "args": ["-y", "mcp-deepwiki@latest"] } } } // Then prompt: // "use deepwiki https://deepwiki.com/shadcn-ui/ui"

Debug

Known issues

gotchaOnly deepwiki.com domains are allowed; other URLs will return DOMAIN_NOT_ALLOWED error.

fix

Ensure URL starts with https://deepwiki.com/

affects: >=0.0.1

gotchaPackage is ESM-only (uses .mjs). CommonJS require() will fail.

fix

Use ESM imports (import) or run via npx/node with --experimental-modules.

affects: >=0.0.1

gotchaNode.js version >=18.0.0 required.

fix

Check Node version with 'node --version' and upgrade if necessary.

affects: >=0.0.1

gotchaThe tool registers a single tool named 'deepwiki_fetch'. There is no separate tool for single vs multiple pages; use mode parameter.

fix

Use 'deepwiki_fetch' with appropriate mode (aggregate/pages) and url parameter.

affects: >=0.0.1

gotchamaxDepth default is 10; large sites may take long or hit rate limits.

fix

Set maxDepth to a lower value (e.g., 1 or 2) for faster results.

affects: >=0.0.1

Errors

Common errors & fixes

Error: Only deepwiki.com domains are allowed

URL provided is not from deepwiki.com

fix

Use a valid deepwiki.com URL (e.g., https://deepwiki.com/shadcn-ui/ui)

Error [ERR_REQUIRE_ESM]: require() of ES Module

Using require() to load the package which is ESM-only

fix

Use 'npx mcp-deepwiki@latest' or add "type": "module" in package.json

Error: Cannot find module 'mcp-deepwiki'

Package not installed or not in node_modules

fix

Run 'npm install -g mcp-deepwiki' or use 'npx mcp-deepwiki@latest'

Error: connect ECONNREFUSED

MCP server process not running

fix

Start the MCP server via npx and ensure it's listening on the expected transport (stdio by default)

Upgrade

Version history

0.0.10latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

41 hits · last 30 days

node

Resources

githubhttps://github.com/regenrek/deepwiki-mcp ↗

packagemcp-deepwiki ↗

homepagehttps://github.com/regenrek/deepwiki-mcp ↗