Search, fetch docs, and ask questions about any open-source repo
π 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
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.goog
Tools (1)
codewiki_search_reposSearch repositories indexed by codewiki.googleEnvironment Variables
CODEWIKI_REQUEST_TIMEOUTTimeout for requests in millisecondsCODEWIKI_MAX_RETRIESMaximum number of retries for failed requestsGITHUB_TOKENGitHub personal access token for API authenticationConfiguration
{"mcpServers": {"codewiki-mcp": {"command": "npx", "args": ["-y", "codewiki-mcp@latest"]}}}