内容
# Gemini 浏览器 MCP
MCP 服务器，通过 Chrome 扩展程序桥接 **Claude Code** 到 **Google Gemini**，无需 API 密钥。
它直接与 Gemini 网页应用交互，意味着您可以在浏览器中获得所有可用功能：Flash、Pro、扩展思考、上传等。
---
## 功能
- **无需 API 密钥** — 使用您现有的浏览器会话。
- **支持所有模型**（Flash、Pro、扩展思考）通过官方网页 UI。
- **双重设置** — 自动配置 Claude Code。
- **扩展程序弹窗** 管理连接的标签页、设置活动目标并查看活动模型。
---
## 快速开始
### 1. 加载 Chrome 扩展程序
1. 将 `chrome-extension/` 文件夹作为解包的扩展程序加载到 Chrome 中：
- 访问 `chrome://extensions/`
- 启用 **开发者模式**（右上角切换按钮）
- 点击 **加载解包**（左上角按钮）
- 从此仓库中选择 `chrome-extension/` 文件夹
2. 在 [gemini.google.com](https://gemini.google.com) 上打开一个标签页并确认您已登录。
### 2. 配置 Claude Code
运行自动安装程序：
```bash
npx gemini-browser-mcp
```
这启动了一个本地设置向导，自动在 Claude Code 中注册 MCP 服务器。
---
## 使用
在 Claude Code 中，您现在可以直接使用 `ask_gemini_web` 工具：
```bash
# 向 Gemini 提问
ask_gemini_web 1+1
# 给它一个任务
ask_gemini_web 用简单的术语解释量子计算
```
### 更改模型
要切换模型，只需在 Chrome 中的活动 Gemini 标签页中更改。扩展程序将自动检测活动模型（Flash、Pro、扩展）并相应地调整超时时间（最多等待 10 分钟以进行扩展思考）。
---
## 技术细节
1. Chrome 扩展程序连接到本地 Node.js WebSocket 服务器（端口 `8085`）。
2. Claude Code 在 stdio 上运行 MCP 服务器。
3. 当您运行 `ask_gemini_web` 时，MCP 服务器将提示信息中继到 Chrome 扩展程序。
4. 内容脚本注入提示信息，点击发送，等待响应在 DOM 中稳定并返回到 Claude。
