codewiki-mcp 是一个 Model Context Protocol (MCP) 服务器，用于将 AI 助手连接到 codewiki.google — 一个为开源仓库生成 AI wiki 文档的服务。
用途：该项目让任意 AI 助手能够访问 codewiki.google，从而搜索仓库、获取完整文档或以自然语言提问，所有操作均通过 MCP 完成。
主要能力：
- codewiki_search_repos：搜索 codewiki.google 已索引的仓库。
- codewiki_fetch_repo：获取某仓库生成的 wiki 内容。
- codewiki_ask_repo：就某仓库提出自然语言问题。
- 支持在任意兼容 MCP 的客户端中使用提示词，例如获取完整文档、获取结构化页面、用自然语言提问。
使用方式：
- 使用 npx（无需安装）。
- MCP 客户端配置：可添加到 .cursor/mcp.json、claude_desktop_config.json、Windsurf MCP 配置或 .vscode/mcp.json。
- 环境变量：可通过环境变量配置，也可在项目根目录创建 .env 文件。
工作原理： codewiki.google 使用 Google 内部 batchexecute RPC 格式（非 REST，非 GraphQL）。客户端构建带有 f.req=... 的 POST 请求，发送到 /_/BoqAngularSdlcAgentsUi/data/batchexecute，接收带 XSSI 前缀 )]}'\n 的响应，解析 wrb.fr 帧并提取类型化负载。每个工具映射到一个 RPC ID。
NLP 仓库解析：用户可输入自然语言而非 owner/repo。
重试机制：使用指数退避重试；4xx 错误（客户端错误）从不重试。
响应格式：错误码包括 VALIDATION、RPC_FAIL、TIMEOUT、NLP_RESOLVE_FAIL。
故障排除：
- 大型仓库可增加超时时间。
- 自然语言输入无法解析时，使用显式格式。
- 设置 GITHUB_TOKEN 以避免 GitHub API 对未认证请求的速率限制。
开发：欢迎贡献。请 Fork 仓库，创建功能分支（git checkout -b feat/my-feature），使用 Conventional Commits 提交信息，提交前运行 npm run typecheck && npm run test，然后打开 Pull Request。
许可：MIT © codewiki-mcp contributors。
