researching-with-deepwiki

name	researching-with-deepwiki
description	Research GitHub, GitLab, and Bitbucket repositories using DeepWiki MCP server. Use when exploring unfamiliar codebases, understanding project architecture, or asking questions about how a specific open-source project works. Provides AI-powered repo analysis and RAG-based Q&A about source code. NOT for fetching library API docs (use fetching-library-docs instead) or local files.

Researching with DeepWiki

Research and understand codebases using the DeepWiki MCP server.

MCP Server Setup

Add to your Claude Code settings:

claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp

Or add to settings.json:

{
  "mcpServers": {
    "deepwiki": {
      "type": "http",
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

Private Repositories

For private repos, use the Devin.ai endpoint with authentication:

{
  "mcpServers": {
    "deepwiki": {
      "type": "http",
      "url": "https://mcp.devin.ai/deepwiki/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_DEVIN_API_KEY"
      }
    }
  }
}

---

When to Use DeepWiki

Scenario	Use DeepWiki?
Exploring unfamiliar open-source codebase	Yes
Understanding project architecture	Yes
Finding how a feature is implemented	Yes
Generating documentation for a repo	Yes
Working with your own local code	No - use Glob/Grep
Quick file lookups in known structure	No - use Read tool

---

Core Capabilities

1. Repository Analysis

Ask DeepWiki to analyze any public repository:

"Analyze the architecture of github.com/vercel/next.js"
"How is the routing system implemented in github.com/remix-run/react-router?"
"What design patterns are used in github.com/anthropics/anthropic-sdk-python?"

2. Code Structure Understanding

Get insights into project organization:

"Explain the directory structure of github.com/langchain-ai/langchain"
"What are the main modules in github.com/fastapi/fastapi?"
"How are tests organized in github.com/pytest-dev/pytest?"

3. Feature Investigation

Understand how specific features work:

"How does streaming work in github.com/openai/openai-python?"
"Where is authentication handled in github.com/better-auth/better-auth?"
"How are middleware implemented in github.com/honojs/hono?"

4. Architecture Visualization

DeepWiki can generate Mermaid diagrams:

"Generate an architecture diagram for github.com/prisma/prisma"
"Show the data flow in github.com/trpc/trpc"

---

Best Practices

1. Be Specific with Questions

# Good - specific question
"How does the caching system work in github.com/vercel/swr?"

# Less effective - too broad
"Tell me about github.com/vercel/swr"

2. Reference Specific Paths

# Good - targeted investigation
"Explain the src/core directory in github.com/pmndrs/zustand"

# Also good - feature-focused
"How is the middleware pattern implemented in github.com/pmndrs/zustand?"

3. Compare Implementations

"Compare how github.com/tanstack/query and github.com/vercel/swr handle cache invalidation"

4. Learn from Popular Projects

"What patterns from github.com/shadcn-ui/ui should I follow for my component library?"

---

Common Use Cases

Learning a New Framework

1. "Explain the core concepts of github.com/honojs/hono"
2. "How do I add middleware in github.com/honojs/hono?"
3. "Show example route handlers from github.com/honojs/hono"

Debugging Integration Issues

1. "How does github.com/drizzle-team/drizzle-orm handle connection pooling?"
2. "What error types are thrown by github.com/drizzle-team/drizzle-orm?"

Preparing for Contributions

1. "What's the contribution workflow for github.com/anthropics/claude-code?"
2. "How are issues labeled in github.com/anthropics/claude-code?"
3. "What testing patterns are used in github.com/anthropics/claude-code?"

---

Supported Platforms

Platform	URL Format
GitHub	github.com/owner/repo
GitLab	gitlab.com/owner/repo
Bitbucket	bitbucket.org/owner/repo

---

Limitations

• Rate limits: Public endpoint has usage limits
• Private repos: Requires Devin.ai API key
• Large repos: May take time to analyze
• Real-time changes: Cached analysis may not reflect latest commits

---

Verification

Run: python3 scripts/verify.py

Expected: ✓ DeepWiki MCP server configured

If Verification Fails

1. Check: MCP server is configured in settings
2. Test: Try a simple query like "analyze github.com/anthropics/anthropic-sdk-python"
3. Stop and report if still failing

References

• DeepWiki - Main service
• MCP endpoint - Public MCP server