CodeWiki MCP — AI-generated docs for GitHub repos

io.github.izzzzziPublished by GitHub account izzzzziv1.1.1Updated Oct 24, 2026

MCP server for codewiki.google: search repos, fetch wiki docs, ask questions

VerifiedSTDIODesktop onlyWeb Search & ScrapingKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Connects an AI assistant to codewiki.google to search GitHub repositories, fetch AI-generated wiki documentation, and ask questions about a repo.

What you can do
Search repositories indexed by codewiki.google, with a result limit up to 50 and metadata such as byte count and elapsed time per response. Fetch a repository's generated wiki as full markdown or as structured pages, accepting owner/repo, a GitHub URL, or a natural-language description. Ask a natural-language question about a repository, optionally passing up to 20 prior conversation turns. Resolve informal descriptions to an owner/repo name using keyword extraction plus the GitHub search API.
When to use it
Useful when you want an assistant to explain how an unfamiliar open-source project works, pull its generated documentation into a conversation, or answer specific questions about a repository without reading the source yourself.
Requirements
Runs locally over stdio, typically via npx with Node.js, or from source or Docker. Needs network access to codewiki.google and, for natural-language repo resolution, the GitHub search API. Optional environment variables include CODEWIKI_BASE_URL, CODEWIKI_REQUEST_TIMEOUT, CODEWIKI_MAX_RETRIES, CODEWIKI_RETRY_DELAY and GITHUB_TOKEN; no authentication is required.
Before you install
Queries and repository names are sent to codewiki.google, which is reached through an undocumented internal Google RPC endpoint that may change or break. Setting GITHUB_TOKEN is optional but exposes a credential to the local process; unauthenticated GitHub lookups are rate-limited. The tools only read data and do not modify repositories.

Installation

In SourceWeft

  1. Open CodeWiki MCP — AI-generated docs for GitHub repos in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

📚 codewiki-mcp

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.

📖 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

FeatureDescription
🔍 Search ReposFind repositories indexed by codewiki.google
📄 Fetch Wiki DocsGet full markdown or structured pages for any repo
💬 Ask QuestionsNatural-language Q&A with conversation history
🧠 NLP Repo ResolutionType naturally — wink-nlp extracts keywords and resolves to owner/repo
📡 Multiple Transportsstdio (default), Streamable HTTP, SSE
🔄 Retry with BackoffAutomatic retries with exponential backoff on 5xx errors
🐳 Docker SupportMulti-stage Alpine build
📊 Response MetadataByte count and elapsed time on every response

🚀 Quick Start

Using npx (no install)

bash
npx -y codewiki-mcp@latest

From source

bash
git clone https://github.com/izzzzzi/codewiki-mcp.gitcd codewiki-mcpnpm installnpm run build

Transports

bash
# stdio (default)node dist/cli.js
# Streamable HTTPnode dist/cli.js --http --port 3000
# SSEnode dist/cli.js --sse --port 3001

🐳 Docker

bash
docker build -t codewiki-mcp .
# stdiodocker run -it --rm codewiki-mcp
# HTTPdocker run -p 3000:3000 codewiki-mcp --http
# with environment variablesdocker 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:

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

Add to claude_desktop_config.json:

json
{  "mcpServers": {    "codewiki-mcp": {      "command": "npx",      "args": ["-y", "codewiki-mcp@latest"]    }  }}
Claude Code
bash
claude mcp add codewiki-mcp -- npx -y codewiki-mcp@latest
Windsurf

Add to your Windsurf MCP config:

json
{  "mcpServers": {    "codewiki-mcp": {      "command": "npx",      "args": ["-y", "codewiki-mcp@latest"]    }  }}
VS Code (Copilot)

Add to .vscode/mcp.json:

json
{  "servers": {    "codewiki-mcp": {      "command": "npx",      "args": ["-y", "codewiki-mcp@latest"]    }  }}
Local development
json
{  "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.jscodewiki 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.

ParameterTypeRequiredDefaultDescription
querystring✅—Search query
limitnumber—10Max results (1–50)

📄 codewiki_fetch_repo

Fetch generated wiki content for a repository.

ParameterTypeRequiredDefaultDescription
repostring✅—owner/repo, GitHub URL, or natural-language query
modestring—"aggregate""aggregate" — full markdown; "pages" — structured JSON

💬 codewiki_ask_repo

Ask a natural-language question about a repository.

ParameterTypeRequiredDefaultDescription
repostring✅—Repository identifier (same formats as fetch)
questionstring✅—Question about the repo
historyarray—[]Conversation history [{role, content}] (max 20)

📊 Response Format

✅ Success — Search
json
{  "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)
json
{  "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
json
{  "answer": "Fastify uses a plugin-based architecture where...",  "meta": {    "totalBytes": 8500,    "totalElapsedMs": 2300  }}
❌ Error Response
json
{  "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:

ToolRPC ID
🔍 SearchvyWDAf
📄 FetchVSX6ub
💬 AskEgIxfe

🧠 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

AttemptDelay
0immediate
1250ms
2500ms
31000ms

4xx errors (client errors) are never retried.

🖥️ CLI

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

⚡ Configuration

Environment variables:

VariableDefaultDescription
CODEWIKI_BASE_URLhttps://codewiki.googleBase URL
CODEWIKI_REQUEST_TIMEOUT30000Request timeout (ms)
CODEWIKI_MAX_RETRIES3Max retries
CODEWIKI_RETRY_DELAY250Base 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=60000CODEWIKI_MAX_RETRIES=5GITHUB_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
bash
chmod +x ./node_modules/.bin/codewiki-mcp
Connection Refused (HTTP/SSE)
bash
# Check if port is in uselsof -i :3000
Timeout Errors

For large repositories, increase the timeout:

bash
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# orhttps://github.com/fastify/fastify

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

🧑‍💻 Development

bash
npm run dev          # stdio with tsxnpm run dev:http     # HTTP with tsxnpm run dev:sse      # SSE with tsxnpm run typecheck    # type checknpm run test         # run testsnpm run test:watch   # tests in watch modenpm 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

Source: README.md at commit 46536bb

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts