用途
google-ai-search-mcp 是一个实现模型上下文协议（MCP）的服务器，面向 AI 编程场景，提供一套由 Google AI 驱动的搜索与文档工具，旨在帮助 AI 编程助手克服大语言模型的知识缺口和信息局限。
主要能力
项目提供两类工具。核心搜索与文档工具包括：
- answer_query_websearch：面向开发者的自然语言查询，具备自动技术检测、增强搜索方法，并利用 Google AI 的实时搜索结果进行代码格式化。
- explain_topic_with_docs：精简的技术解释，改进调试场景，从官方文档综合信息，降低冗长并增强故障排除指导。
- get_doc_snippets：增强的代码片段检索，提供渐进式复杂度示例、高级搜索模式、版本特定目标定位，以及针对官方文档技术查询的完整上下文。
- generate_project_guidelines：根据指定技术生成结构化项目指南文档，使用网络搜索获取当前最佳实践和行业标准。
高级分析工具包括：
- code_analysis_with_docs：基于证据的代码分析，提供标准化引用、严重性分类和可操作建议，将代码与官方文档最佳实践进行对比。
- technical_comparison：使用可用的当前搜索上下文，按请求的标准生成技术比较。量化或市场声明需对照引用的原始来源进行核实。
- architecture_pattern_recommendation：为描述的使用场景生成架构选项、权衡取舍和实施考虑。采纳建议前需对照系统的实际约束进行验证。
各工具的输入/输出模式定义在 src/tools/ 内的相应文件中，并通过 MCP 服务器暴露。
配置与使用方式
配置文件通过环境变量控制，可配置模型 ID、温度、流式行为、最大输出 token 和重试设置。默认使用流式 API 以获得更好的响应性，包含针对瞬态 API 错误的基本重试逻辑。应用最小安全过滤（BLOCK_NONE）以减少潜在阻断（需谨慎使用）。
前置条件：Bun（可通过 npm install -g bun 安装）；使用 Vertex AI 时需要启用计费的 Google Cloud 项目；在 GCP 项目中启用 Vertex AI API；环境中配置 Google Cloud 身份验证（推荐通过 gcloud auth application-default login 使用应用默认凭据，或使用服务账号密钥）或 Gemini API 密钥。
设置与安装步骤：
- 克隆/放置项目到目标位置。
- 安装依赖：bun install
- 配置环境：在项目根目录创建 .env 文件（复制 .env.example），按 .env.example 说明设置必需和可选环境变量。将 AI_PROVIDER 设为 "vertex" 或 "gemini"。若 AI_PROVIDER="vertex"，需要 GOOGLE_CLOUD_PROJECT；若 AI_PROVIDER="gemini"，需要 GEMINI_API_KEY。
- 构建服务器：bun run build，将 TypeScript 代码编译到 build/index.js。
独立运行 / NPX：该包已发布到 npm，可直接用 npx 运行，或全局安装。独立运行前需在 shell 环境中设置必要的环境变量（如 GOOGLE_CLOUD_PROJECT、GOOGLE_CLOUD_LOCATION、GEMINI_API_KEY、身份验证凭据等）。
Docker：构建本地容器镜像后，可用 Gemini API 提供商运行。使用 Vertex AI 时，传入 AI_PROVIDER=vertex、GOOGLE_CLOUD_PROJECT 和可选的 GOOGLE_CLOUD_LOCATION，同时容器内需提供应用默认凭据（通常通过只读凭据挂载）。不要将 API 密钥或服务账号文件烘焙到镜像中。
与 Cline 配合使用：在 Cline MCP 设置文件（如 .roo/mcp.json）中添加/更新配置，有两种主要方式配置命令。方式 A 使用 Node 直接运行编译脚本，适合本地开发，需确保 args 路径正确指向 build/index.js，使用绝对路径可能更可靠。方式 B 使用 NPX 自动从 npm 注册表下载并运行服务器包，无需克隆仓库。确保 env 块中的环境变量正确设置，与实际 .env 一致或在此显式定义。之后重启/重载 Cline，即可使用这些工具。
开发命令：监视模式 bun run watch；构建 bun run build；检查器 bun run inspector。
适用场景与限制
该工具适用于 AI 编程助手在编码过程中需要实时信息检索、官方文档引用、代码质量分析、技术选型比较或架构建议的场景。
实施说明指出：提供商选择和凭据在运行时解析，因此工具被列出并不证明其上游提供商已配置或可达。应将模型生成的比较、架构指导和安全分析视为需要对照所引用的原始来源进行验证的材料，而非确定性结论。
项目采用 MIT 许可证，详见 LICENSE 文件。
