内容
# Gemini 网络 — MCP 服务器
**真正的谷歌搜索、多页面摘要和 Nano Banana 图片生成 — 适用于任何 MCP 客户端。**
三种 Gemini 工具：
- **`web_search`** — 通过 Gemini 的基础功能实现真正的谷歌搜索，并附带引用的源网址。
- **`summarize_pages`** — 获取并合成最多 20 个网址的摘要，只需一次调用（支持 HTML、PDF、JSON、图片 — 每页最大 34 MB）。
- **`generate_image`** — 通过 Gemini 的“Nano Banana”模型实现文本转图片、图片编辑和多图片融合，并保存到磁盘。
为您的客户端内置网络工具提供无缝升级 — 更广泛的覆盖范围，一次性多网址合成 — 以及许多客户端不提供的图片生成功能。尤其适用于 Claude Code，搭配 Bedrock 或 Vertex Anthropic 后端使用时，这些后端不提供内置的 WebSearch 功能。
## 用法
直接询问模型。以下是几个示例：
**`web_search`：**
> 使用 Gemini 研究所有主要的图片生成模型，并比较它们的优缺点。
**`summarize_pages`：**
> 总结 <url> 中论文的关键更改。
**`generate_image`：**
> 生成一张复古的 8 位像素风格的香蕉悬浮在太空中的图片，并保存为 `/Users/me/proj/assets/hero.png`。
> 将 `/Users/me/Downloads/sketch.png` 转换为水彩画。
## 安装
该服务器是一个单独的 Python 文件，包含 [PEP 723 内联脚本元数据](https://peps.python.org/pep-0723/)，因此 `uv run --script`会在首次启动时自动安装依赖项。安装 `uv` 一次即可完成设置。
### Claude Code
独立安装（此仓库本身是一个插件市场）：
```bash
/plugin marketplace add Jacksunwei/gemini-web-mcp
/plugin install gemini-web@gemini-web-mcp
```
或通过 [`jacksunwei-marketplace`](https://github.com/Jacksunwei/jacksunwei-marketplace) 索引市场安装：
```bash
/plugin marketplace add jacksunwei/jacksunwei-marketplace
/plugin install gemini-web@jacksunwei-marketplace
```
### Gemini CLI、Codex CLI、Antigravity 及其他 MCP 客户端
将仓库克隆到一个稳定的位置：
```bash
git clone https://github.com/Jacksunwei/gemini-web-mcp.git ~/mcp/gemini-web-mcp
```
然后使用绝对路径在您的客户端中注册服务器。
**Gemini CLI** — 编辑 `~/.gemini/settings.json`：
```json
{
"mcpServers": {
"gemini-web": {
"command": "uv",
"args": ["run", "--script", "/Users/you/mcp/gemini-web-mcp/server/server.py"],
"env": {
"GOOGLE_API_KEY": "your-aistudio-key"
}
}
}
}
```
或将其安装为 Codex 插件市场：
```bash
codex plugin marketplace add Jacksunwei/gemini-web-mcp
```
然后打开 Codex 插件目录，从 `gemini-web-mcp` 市场安装 **Gemini Web**。
**Codex CLI** — 编辑 `~/.codex/config.toml`：
```toml
[mcp_servers.gemini-web]
command = "uv"
args = ["run", "--script", "/Users/you/mcp/gemini-web-mcp/server/server.py"]
[mcp_servers.gemini-web.env]
GOOGLE_API_KEY = "your-aistudio-key"
```
**Antigravity** — 打开代理管理器 → MCP 商店 → “添加自定义服务器”，并使用上述相同的 `command`、`args` 和 `env` 格式。
对于没有插件安装提示的客户端，请通过环境变量配置身份验证（上述 `GOOGLE_API_KEY`，或 Vertex ADC — 请参见下面的[高级：环境变量身份验证](#高级环境变量身份验证)）。
## 配置
**首次使用时：** Claude Code 在 `/plugin install` 后会提示您填写以下字段。请填写 API 密钥（其余字段可以保持默认值）。
**后续：** 要更改任何设置，请运行 `/plugin`，选择 **gemini-web**，并编辑其配置。
| 字段 | 默认值 | 备注 |
| --- | --- | --- |
| **Gemini API 密钥** | _无_ | 您的 [AI Studio 密钥](https://aistudio.google.com/apikey)。存储在您的系统密钥链中。 |
| **搜索/摘要模型** | `gemini-flash-latest` | 由 `web_search` 和 `summarize_pages` 使用。必须支持 `google_search` 基础功能和 `url_context` 工具。 |
| **图片生成模型** | `gemini-3.1-flash-image-preview` | Nano Banana 2. 可覆盖为 `gemini-2.5-flash-image`（GA Nano Banana）或 `gemini-3-pro-image-preview`（Nano Banana Pro）。 |
> 需要 Vertex AI 或环境变量身份验证？请参见下面的[高级：环境变量身份验证](#高级环境变量身份验证)。
## 高级：环境变量身份验证
如果您无法（或不想）使用插件 UI 进行 API 密钥配置 — 例如，您正在使用 Vertex AI，在多台机器上共享设置，或使用脚本安装 — 请留空 **Gemini API 密钥** 字段并改为设置环境变量。`google-genai` SDK 会根据您的环境自动选择身份验证路径：
**Gemini API 密钥（个人用户）：**
```bash
export GOOGLE_API_KEY=your-key # https://aistudio.google.com/apikey
export GOOGLE_GENAI_USE_VERTEXAI=false # 仅在之前设置为 true 时需要
```
**Vertex AI + ADC（企业/谷歌内部）：**
```bash
gcloud auth application-default login
gcloud auth application-default set-quota-project YOUR_PROJECT_ID
export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID
export GOOGLE_CLOUD_LOCATION=us-central1
# Vertex AI API 必须在项目上启用。
```
如果 **Gemini API 密钥** 插件字段和 `GOOGLE_*` 环境变量都已设置，则插件字段优先。
## 许可证
Apache 2.0 — 请参见 [LICENSE](LICENSE)。
