Codewiki MCP Server

📚 codewiki-mcp

MCP server for codewiki.google — search, fetch docs, and ask questions about any open-source repo

🇷🇺 Русский | 🇬🇧 English

MCP server that connects any AI assistant to codewiki.google — AI-generated wiki documentation for open-source repositories.

---

📖 Overview

codewiki-mcp is a Model Context Protocol server that gives AI assistants access to codewiki.google — a service that generates comprehensive wiki documentation for any GitHub repository. Search repos, fetch full docs, or ask natural-language questions — all through MCP.

---

✨ Features

Feature	Description
🔍 Search Repos	Find repositories indexed by codewiki.google
📄 Fetch Wiki Docs	Get full markdown or structured pages for any repo
💬 Ask Questions	Natural-language Q&A with conversation history
🧠 NLP Repo Resolution	Type naturally — wink-nlp extracts keywords and resolves to owner/repo
📡 Multiple Transports	stdio (default), Streamable HTTP, SSE
🔄 Retry with Backoff	Automatic retries with exponential backoff on 5xx errors
🐳 Docker Support	Multi-stage Alpine build
📊 Response Metadata	Byte count and elapsed time on every response

---

🚀 Quick Start

Using npx (no install)

npx -y codewiki-mcp@latest

From source

git clone https://github.com/izzzzzi/codewiki-mcp.git
cd codewiki-mcp
npm install
npm run build

Transports

# stdio (default)
node dist/cli.js

# Streamable HTTP
node dist/cli.js --http --port 3000

# SSE
node dist/cli.js --sse --port 3001

🐳 Docker

docker build -t codewiki-mcp .

# stdio
docker run -it --rm codewiki-mcp

# HTTP
docker run -p 3000:3000 codewiki-mcp --http

# with environment variables
docker run -p 3000:3000 \
  -e CODEWIKI_REQUEST_TIMEOUT=60000 \
  -e CODEWIKI_MAX_RETRIES=5 \
  -e GITHUB_TOKEN=ghp_your_token \
  codewiki-mcp --http

---

🔧 MCP Client Configuration

<details> <summary><b>Cursor</b></summary>

Add to .cursor/mcp.json:

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

</details> <details> <summary><b>Claude Desktop</b></summary>

Add to claude_desktop_config.json:

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

</details> <details> <summary><b>Claude Code</b></summary>

claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest

</details> <details> <summary><b>Windsurf</b></summary>

Add to your Windsurf MCP config:

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

</details> <details> <summary><b>VS Code (Copilot)</b></summary>

Add to .vscode/mcp.json:

{
  "servers": {
    "codewiki-mcp": {
      "command": "npx",
      "args": ["-y", "codewiki-mcp@latest"]
    }
  }
}

</details> <details> <summary><b>Local development</b></summary>

{
  "mcpServers": {
    "codewiki-mcp": {
      "command": "node",
      "args": ["/path/to/codewiki-mcp/dist/cli.js"]
    }
  }
}

</details>

---

💡 Usage

Prompts you can use in any MCP-compatible client:

codewiki fetch how routing works in Next.js

codewiki search state management libraries

codewiki ask how does React fiber reconciler work?

Fetch complete documentation:

codewiki fetch vercel/next.js
codewiki fetch https://github.com/fastify/fastify

Get structured pages:

codewiki fetch pages tailwindlabs/tailwindcss

Ask with natural language:

codewiki ask fastify how to add authentication?

---

🛠️ MCP Tools

🔍 codewiki_search_repos

Search repositories indexed by codewiki.goog