CodeWiki MCP — AI-generated docs for GitHub repos

📚 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

---

🚀 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

Cursor

Add to .cursor/mcp.json:

{

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

Claude Desktop

Add to claude_desktop_config.json:

{

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

Claude Code

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

Windsurf

Add to your Windsurf MCP config:

{

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

VS Code (Copilot)

Add to .vscode/mcp.json:

{

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

Local development

{

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

---

💡 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.google.

📄 codewiki_fetch_repo

Fetch generated wiki content for a repository.

💬 codewiki_ask_repo

Ask a natural-language question about a repository.

---

📊 Response Format

✅ Success — Search

{

"query": "fastify", "count": 1, "items": [ { "fullName": "fastify/fastify", "url": "https://github.com/fastify/fastify", "description": "Fast and low overhead web framework", "avatarUrl": "https://avatars.githubusercontent.com/u/24939....", "extraScore": 555 } ], "meta": { "totalBytes": 12500, "totalElapsedMs": 450 } }

✅ Success — Fetch (pages mode)

{

"repo": "fastify/fastify", "commit": "abc123", "canonicalUrl": "https://github.com/fastify/fastify", "pages": [ { "title": "Overview", "level": 1, "anchor": "#overview", "markdown": "# Overview\n\nFastify is a web framework...", "diagramCount": 1 } ], "meta": { "totalBytes": 25000, "totalElapsedMs": 1200 } }

✅ Success — Ask

{

"answer": "Fastify uses a plugin-based architecture where...", "meta": { "totalBytes": 8500, "totalElapsedMs": 2300 } }

❌ Error Response

{

"error": { "code": "RPC_FAIL", "message": "CodeWiki RPC VSX6ub failed with status 404", "rpcId": "VSX6ub", "statusCode": 404 } }

Error codes: VALIDATION, RPC_FAIL, TIMEOUT, NLP_RESOLVE_FAIL

---

⚙️ How It Works

Data Flow

AI Assistant → MCP protocol → codewiki-mcp → HTTPS → codewiki.google

↓ AI Assistant ← MCP protocol ← codewiki-mcp ← JSON ← Google RPC API

Google Batchexecute RPC

codewiki.google uses Google's internal batchexecute RPC format (not REST, not GraphQL). The client:

1. Builds a POST request with f.req=... body
2. Sends it to /_/BoqAngularSdlcAgentsUi/data/batchexecute
3. Receives a response with XSSI prefix )]}'\n
4. Parses wrb.fr frames and extracts the typed payload

Each tool maps to an RPC ID:

🧠 NLP Repo Resolution

Users can type natural language instead of owner/repo:

"the fastify web framework"

→ wink-nlp extracts keyword "fastify" (POS tag: NOUN/PROPN) → GitHub Search API: GET /search/repositories?q=fastify&sort=stars → top result: "fastify/fastify" → normalizeRepoInput("fastify/fastify") → URL for codewiki

🔄 Retry with Exponential Backoff

4xx errors (client errors) are never retried.

---

🖥️ CLI

codewiki-mcp [options]

Options: --http Streamable HTTP transport --sse SSE transport --port Port for HTTP/SSE (default: 3000) --endpoint URL endpoint (default: /mcp) --help, -h Show help

---

⚡ Configuration

Environment variables:

You can also create a .env file in the project root:

CODEWIKI_REQUEST_TIMEOUT=60000

CODEWIKI_MAX_RETRIES=5 GITHUB_TOKEN=ghp_your_token

---

📁 Project Structure

src/

├── cli.ts # CLI entry point ├── server.ts # Transport setup (stdio/HTTP/SSE) ├── index.ts # Library re-exports ├── schemas.ts # Zod input schemas ├── lib/ │ ├── codewikiClient.ts # API client with retry + metadata │ ├── batchexecute.ts # Google RPC response parser │ ├── repo.ts # Repo normalization + NLP resolution │ ├── extractKeyword.ts # NLP keyword extraction (wink-nlp) │ ├── resolveRepo.ts # GitHub Search API resolver │ ├── errors.ts # CodeWikiError + formatMcpError │ └── config.ts # Env-based configuration └── tools/ ├── searchRepos.ts # codewiki_search_repos ├── fetchRepo.ts # codewiki_fetch_repo └── askRepo.ts # codewiki_ask_repo

---

❓ Troubleshooting

Permission Denied

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

Connection Refused (HTTP/SSE)

# Check if port is in use

lsof -i :3000

Timeout Errors

For large repositories, increase the timeout:

CODEWIKI_REQUEST_TIMEOUT=60000 node dist/cli.js

NLP Resolution Fails

If natural-language input doesn't resolve, use explicit format:

# Instead of "the fastify framework"

fastify/fastify

or

https://github.com/fastify/fastify

Set GITHUB_TOKEN to avoid GitHub API rate limits for unauthenticated requests.

---

🧑💻 Development

npm run dev          # stdio with tsx

npm run dev:http # HTTP with tsx npm run dev:sse # SSE with tsx npm run typecheck # type check npm run test # run tests npm run test:watch # tests in watch mode npm run build # compile to dist/

---

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feat/my-feature)
3. Use Conventional Commits for commit messages
4. Run npm run typecheck && npm run test before submitting
5. Open a Pull Request

---

📄 License

MIT © codewiki-mcp contributors