MCP server for codewiki.google — search, fetch docs, and ask questions about any open-source repo
CI Release npm version npm downloads License: MIT TypeScript Node.js
🇷🇺 Русский | 🇬🇧 English
MCP server that connects any AI assistant to codewiki.google — AI-generated wiki documentation for open-source repositories.
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.
| 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 |
npx -y codewiki-mcp@latest
git clone https://github.com/izzzzzi/codewiki-mcp.git
cd codewiki-mcp
npm install
npm run build# stdio (default) node dist/cli.js # Streamable HTTP node dist/cli.js --http --port 3000 # SSE node dist/cli.js --sse --port 3001
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
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"]
}
}
}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?
Search repositories indexed by codewiki.google.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query |
string | ✅ | — | Search query |
limit |
number | — | 10 | Max results (1–50) |
Fetch generated wiki content for a repository.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
repo |
string | ✅ | — | owner/repo, GitHub URL, or natural-language query |
mode |
string | — | "aggregate" |
"aggregate" — full markdown; "pages" — structured JSON |
Ask a natural-language question about a repository.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
repo |
string | ✅ | — | Repository identifier (same formats as fetch) |
question |
string | ✅ | — | Question about the repo |
history |
array | — | [] |
Conversation history [{role, content}] (max 20) |
✅ 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
AI Assistant → MCP protocol → codewiki-mcp → HTTPS → codewiki.google
↓
AI Assistant ← MCP protocol ← codewiki-mcp ← JSON ← Google RPC API
codewiki.google uses Google's internal batchexecute RPC format (not REST, not GraphQL). The client:
- Builds a POST request with
f.req=...body - Sends it to
/_/BoqAngularSdlcAgentsUi/data/batchexecute - Receives a response with XSSI prefix
)]}'\n - Parses
wrb.frframes and extracts the typed payload
Each tool maps to an RPC ID:
| Tool | RPC ID |
|---|---|
| 🔍 Search | vyWDAf |
| 📄 Fetch | VSX6ub |
| 💬 Ask | EgIxfe |
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
| Attempt | Delay |
|---|---|
| 0 | immediate |
| 1 | 250ms |
| 2 | 500ms |
| 3 | 1000ms |
4xx errors (client errors) are never retried.
codewiki-mcp [options]
Options:
--http Streamable HTTP transport
--sse SSE transport
--port <number> Port for HTTP/SSE (default: 3000)
--endpoint <str> URL endpoint (default: /mcp)
--help, -h Show help
Environment variables:
| Variable | Default | Description |
|---|---|---|
CODEWIKI_BASE_URL |
https://codewiki.google |
Base URL |
CODEWIKI_REQUEST_TIMEOUT |
30000 |
Request timeout (ms) |
CODEWIKI_MAX_RETRIES |
3 |
Max retries |
CODEWIKI_RETRY_DELAY |
250 |
Base retry delay (ms) |
GITHUB_TOKEN |
— | GitHub token for NLP repo resolution |
You can also create a .env file in the project root:
CODEWIKI_REQUEST_TIMEOUT=60000
CODEWIKI_MAX_RETRIES=5
GITHUB_TOKEN=ghp_your_token
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
Permission Denied
chmod +x ./node_modules/.bin/codewiki-mcp
Connection Refused (HTTP/SSE)
# Check if port is in use
lsof -i :3000Timeout 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.
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/
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch (
git checkout -b feat/my-feature) - Use Conventional Commits for commit messages
- Run
npm run typecheck && npm run testbefore submitting - Open a Pull Request
MIT © codewiki-mcp contributors