用途：在任意 agent 会话中通过已注册的 gemini-cli MCP server 调用 Gemini 能力。MCP server 启动命令：npx -y @tuannvm/gemini-mcp-server。
主要能力（五个核心工具）：gemini 用于文件或代码库分析，可用 @ 引用文件；web-search 提供带 Google Search grounding 的实时网络搜索；analyze-media 分析图片、PDF、截图；brainstorm 做结构化创意头脑风暴；shell 生成 shell 命令，默认 dry-run，需显式设 dryRun: false 才执行。
典型用法：实时信息或技术趋势用 web-search，参数 query；分析整个代码库用 gemini，prompt 写“分析 @.”；分析单个文件如 prompt: “解释 @src/main.ts”；读取截图或 PDF 用 analyze-media，传 filePath 与 prompt；方案构思用 brainstorm，传 prompt 与 methodology；生成 shell 命令用 shell，传 task 并保持 dryRun: true 预览。
模型：gemini-3-pro-preview 最强，适合复杂推理，为 gemini 默认；gemini-3-flash-preview 快速均衡，为 web-search 与 shell 默认；gemini-2.5-flash-lite 最快、轻量。
结果接收：MCP 工具调用为请求-响应模式，必须 await 返回值再继续，不得忽略响应或并发触发后不等待。响应结构为 { content: [...] }，实际文本在 content[0].text。响应为空或工具报错时应停止并报告调用方，不得用空结果继续。
固定规则：MCP server 须已在 agent config 注册，key 为 gemini-cli；每次调用须等待响应完成，链式调用尤其如此；shell 默认 dryRun: true；yolo: true 仅用于 Gemini CLI Extensions（如 Google Workspace），日常分析不加；changeMode: true 仅用于结构化代码修改，日常不加。完整参数见 references/tool-specs.md。