Google Developer Knowledge：让 AI 工具直接检索官方开发文档

1. 一句话结论

Google Developer Knowledge 把 Google 的公开开发文档做成机器可读 API，并通过官方远程 MCP Server 向 AI 助手提供搜索、取全文和有依据回答工具。[S1][S2] 它适合减少依赖过时训练数据或网页抓取，但只能覆盖官方语料范围，不能替代项目代码、运行日志和版本验证。

2. 项目定位

Google 于 2026 年 2 月以公开预览发布 Developer Knowledge API 与配套 MCP Server，随后持续扩展接口和语料。[S1] 其目标是给 IDE、编码助手和智能体一个官方文档入口，而非再发布一个通用搜索引擎。远程端点使用标准 MCP 交互，使不同兼容客户端能复用同一知识服务。[S2]

3. 核心能力

官方 MCP 参考列出 search_documents、get_documents 与 answer_query 三类工具。[S2] 前两者先查相关片段再取完整文档，后者返回基于同一语料合成的答案与引用。API 侧也可直接检索和获取 Markdown 文档。[S1] 合理工作流应先缩小问题，再取少量原文，不应一次拉取大量页面占满上下文。

4. 语料与新鲜度

首发材料说明语料覆盖 Firebase、Android、Google Cloud 等官方开发站点，并在预览期持续重新索引。[S1] 当前 MCP 参考列出更多 Google 开发者域名和产品。[S2] 覆盖广不等于无遗漏；具体产品、语言、版本或刚更新页面仍需检查返回 URI、页面日期和版本标识。

5. 接入方式

客户端连接 https://developerknowledge.googleapis.com/mcp，再依据环境配置认证和 Google Cloud 项目。[S2] 团队应使用专用项目与受限凭据，并只向需要的客户端开放服务。上线前先验证工具列表、一次搜索、一次全文获取和一次不可回答问题，确认超时、权限错误与空结果不会被客户端伪装成确定答案。

6. 适用场景

适合查询 API 用法、查找官方代码示例、定位错误说明和比较 Google 产品的官方能力。它不适合回答第三方库实现、私有仓库行为、社区经验或实际云资源状态。若问题涉及正在运行的系统，应把知识检索与代码、配置、日志及监控工具分开，并让最终结论同时引用静态文档和现场证据。

7. 与普通网页检索的差异

普通网页搜索覆盖更广，但结果可能混入旧博客、转述和低质量页面；Developer Knowledge 牺牲广度，换取官方语料、结构化工具和可回溯 URI。[S1][S2] 团队可把它作为 Google 技术问题的优先入口，再在语料缺失时升级到官方站点定点浏览，而不是默认让 Agent 任意抓取整个网络。

8. 主要风险

风险包括文档本身滞后、语料覆盖缺口、检索片段脱离上下文、认证配置过宽，以及一次取回过多文本导致成本和上下文污染。MCP 标准化了调用，不会自动保证答案正确。应限制单次文档数，保留来源 URI，并要求涉及删除、权限、计费和生产变更的命令由人工核对原页。

9. 验收建议

准备十个已知答案问题，覆盖明确命中、跨文档比较、版本歧义和语料外问题。合格结果应返回正确官方 URI，全文与片段一致，无法支持时明确拒答；客户端还应在凭据撤销、配额不足和网络失败时暴露错误。再统计每次取回字符数与实际引用数，避免“接入成功”却带来无效上下文膨胀。

10. 来源与更新时间

• 信息截至(as_of)：2026-08-12
• [S1] Tier1｜Google Developers Blog：Introducing the Developer Knowledge API and MCP Server｜链接｜访问日期：2026-08-12
• [S2] Tier1｜Google for Developers：Developer Knowledge MCP Reference｜链接｜访问日期：2026-08-12