Quick Install
pip install codewiki-mcp
playwright install chromiumThen add to your editor — see Editor Setup for step-by-step instructions.
Features
5 MCP Tools
Topics overview, structure (JSON TOC), full/section content, interactive Gemini chat Q&A, and repo indexing requests.
Playwright-Powered
Full headless Chromium rendering — handles CodeWiki's Angular SPA perfectly.
Diagram Extraction
Detects CodeWiki diagrams, Mermaid blocks, and inline SVGs. Parses Graphviz into entities & relationships.
In-Memory Caching
TTLCache avoids redundant renders — wiki pages cached for 5 minutes, configurable.
Pydantic Validation
Schema-based input validation with clear error messages and structured JSON responses.
Keyword Resolution
Type just "react" instead of facebook/react. Auto-resolves via CodeWiki search + GitHub API fallback with interactive disambiguation.
Multi-Transport
Stdio (default) or SSE. Docker support included. Environment variable configuration.
How It Works
Google CodeWiki is an Angular SPA — a plain HTTP GET returns an empty body. CodeWiki MCP uses Playwright headless Chromium to render every page, then parses the result with BeautifulSoup to extract clean, structured content.
All 5 tools share a browser singleton with a persistent background event loop. Pages are cached so repeated requests skip the render entirely. The search tool interacts with the Gemini-powered chat panel to get AI answers about any codebase.
Learn more about the architecture →
Supported Repositories
Any public repository on GitHub, GitLab, or Bitbucket that Google CodeWiki covers. Use full URLs, owner/repo shorthand, or bare keywords:
repo_url: microsoft/vscode
repo_url: https://github.com/facebook/react
repo_url: golang/go
# Bare keywords (v1.2.0+) — auto-resolved
repo_url: react
repo_url: vue
repo_url: fastapi