CodeWiki MCP — AI-generated docs for GitHub repos

io.github.izzzzzi由 GitHub 账号 izzzzzi 发布v1.1.1更新于 Oct 24, 2026

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

已验证STDIO仅桌面网页搜索与抓取知识与记忆开发者工具

概览

AI 生成的概览

将 AI 助手连接到 codewiki.google，可搜索 GitHub 仓库、获取 AI 生成的 wiki 文档，并就某个仓库提问。

可以做什么
搜索 codewiki.google 已收录的仓库，可限制返回数量（最多 50 条），并附带字节数与耗时等元数据。获取仓库生成的 wiki，支持完整 markdown 或结构化页面两种形式，仓库可用 owner/repo、GitHub 链接或自然语言描述指定。就某个仓库提出自然语言问题，可选传入最多 20 条历史对话。通过关键词提取加 GitHub 搜索接口，把口语化描述解析为 owner/repo。
适用场景
适合让助手讲解不熟悉的开源项目如何运作、把其生成的文档引入对话，或在不自行阅读源码的情况下回答关于某个仓库的具体问题。
运行要求
以 stdio 在本地运行，通常通过 npx 配合 Node.js，也可从源码或 Docker 启动。需要访问 codewiki.google 的网络，自然语言仓库解析还需访问 GitHub 搜索接口。可选环境变量包括 CODEWIKI_BASE_URL、CODEWIKI_REQUEST_TIMEOUT、CODEWIKI_MAX_RETRIES、CODEWIKI_RETRY_DELAY 和 GITHUB_TOKEN；无需身份验证。
安装前请注意
查询内容和仓库名会发送到 codewiki.google，该服务通过未公开的 Google 内部 RPC 接口访问，可能变更或失效。GITHUB_TOKEN 为可选项，但会把凭据交给本地进程；未认证的 GitHub 查询有速率限制。这些工具只读取数据，不会修改仓库。

安装

在 SourceWeft 中

  1. 打开 控制台中的 CodeWiki MCP — AI-generated docs for GitHub repos，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源：README.md，提交 46536bb

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分