Gemini Webapi MCP

gemini-webapi-mcp

MCP-сервер для Google Gemini — генерация и редактирование изображений, чат и анализ файлов через браузерные cookies.

Без API-ключей. Бесплатно.

______________________________________________________________________

机会

• 图像生成 文本描述（Nano Banana 2，支持比例）
• 2x许可证 -自动下载更新版本（2048x2048→2816x1536及更高版本）
• 图像编辑 -发送图片+PROMPT并接收修改后的版本
• 文件分析 -视频、图像、PDF、文档
• 文本聊天 с双子座（闪光、专业、闪光思维）
• 自动清除水印 -精确删除Gemini（反向字母混合）标签
• 自动身份验证 Chrome的Cookies

快速启动

1.登录Gemini

打开Chrome，转到 gemini.google.com 登录您的Google帐户。

2.安装MCP服务器

GitHub（没有克隆）：

uv run --with "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git" gemini-webapi-mcp

本地安装：

git clone https://github.com/AndyShaman/gemini-webapi-mcp.git
cd gemini-webapi-mcp
uv sync
uv run gemini-webapi-mcp

3.添加MCP配置

Claude Code

claude mcp add-json gemini '{"command":"uv","args":["run","--with","gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git","gemini-webapi-mcp"]}'

或者手动添加到 .mcp.json 在项目的根：

{
  "mcpServers": {
    "gemini": {
      "command": "uv",
      "args": ["run", "--with", "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git", "gemini-webapi-mcp"]
    }
  }
}

Claude Desktop

添加到Claude Desktop配置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gemini": {
      "command": "uv",
      "args": ["run", "--with", "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git", "gemini-webapi-mcp"]
    }
  }
}

Другие MCP-клиенты

使用标准MCP标准配置：

{
  "mcpServers": {
    "gemini": {
      "command": "uv",
      "args": ["run", "--with", "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git", "gemini-webapi-mcp"]
    }
  }
}

配置文件的路径取决于您的MCP客户端。

Локальная установка (после клонирования) — замените args на:

"args": ["--directory", "/path/to/gemini-webapi-mcp", "run", "gemini-webapi-mcp"]

4.安装Claude Code技能（可选）

文件夹 skill/ 包含Claude Code的技能-推广提示、图兰文档和图像生成指南。使用Gemini时会自动激活技能。

cp -r skill ~/.claude/skills/gemini-mcp

5.检查

手动启动服务器-如果初始化没有错误，一切正常：

uv run --with "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git" gemini-webapi-mcp

打开Claude Code或Claude Desktop并尝试： *“通过双子座生成一个水彩猫图片”*.

认证

服务器通过Chrome自动读取cookies browser-cookie3.

多个Google帐户？ 安装 GEMINI_ACCOUNT_INDEX Chrome帐号（0=第一，1=第二，…）。查看顺序：单击Gemini.google.com上的化身。

如果自动检测cookies不起作用，请手动设置它们：

1. 在gemini.google.com上打开Chrome DevTools→Application→Cookies
2. 复制值 __Secure-1PSID 和 __Secure-1PSIDTS
3. 添加到MCP配置：

{
  "mcpServers": {
    "gemini": {
      "command": "uv",
      "args": ["run", "--with", "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git", "gemini-webapi-mcp"],
      "env": {
        "GEMINI_PSID": "your__Secure-1PSID_value",
        "GEMINI_PSIDTS": "your__Secure-1PSIDTS_value"
      }
    }
  }
}

环境变量

变量描述为默认值。 |------------|----------|--------------| | GEMINI_PSID Cookie的重要性 __Secure-1PSID Chrome的车 | GEMINI_PSIDTS Cookie的重要性 __Secure-1PSIDTS Chrome的车 | GEMINI_LANGUAGE Gemini（ru, en, ja, ...) | en | | GEMINI_ACCOUNT_INDEX Google帐号（0，1，2，…） 0 |

高分辨率（2x）

服务器会自动向Google查询生成图像的放大版本，这与Gemini web界面中使用的“下载”按钮相同。Google运行Server-Side Upscale，您可以获得2x分辨率的图像：

原生模式2x（下载） |--------|----------|------------------| |闪电思维（16:9）|1408x768|2816x1536| |闪电思维（9:16）|768x1376|1536x2752| |闪电思维（1:1）|1024x1024|2048x2048|

如果2X版本不可用（超时，网络错误），服务器将自动使用本机权限。

去除水印

Gemini在生成图像的右下角添加了一个火花标记（四角星）。服务器使用算法自动删除它。 反向阿尔法混合 -从数学上精确恢复原始像素。不需要额外的依赖关系或下载模型。

工具

工具描述 |------------|----------| | gemini_generate_image –创建新图像或编辑现有图像› | gemini_upload_file –文件分析-视频、图像、PDF、文档› | gemini_analyze_url –分析URL-Youtube-视频、网页、文章› | gemini_chat –文本聊天（单人或多turn）→ | gemini_start_chat 开始Multi-Turn会话 | gemini_reset –在授权错误时重新授权客户端›

模型

我的默认模式是备注。 |--------|------------------|------------| | gemini-3.0-flash 文件分析快速 | gemini-3.0-flash-thinking –图像生成–Nano Banana 2，比例支持→ | gemini-3.0-pro 是替代模式。

使用示例

设置MCP配置后，Claude会调用所需的工具。只要在聊天室问：

我的任务是写Claude。 |--------|---------------------| 要生成图像。 *“通过双子座产生水彩风格的猫”* | 编辑图片 *“通过Gemini/path/to/cat.png编辑-使猫变灰色”* | -迭代编辑。 *“让背景变黑”* （同一次谈话） 分析视频 *通过Gemini分析此视频：https://youtube.com/watch?v=...»* | 分析档案 *“下载到Gemini/Path/to/doc.pdf并做一个简短的总结”* |

Claude将调用的工具：

gemini_generate_image(prompt="кот в акварельном стиле")
gemini_generate_image(prompt="сделай кота серым", files=["/path/to/cat.png"])
gemini_generate_image(prompt="сделай фон темнее", conversation_id=["c_abc", "r_123", "rc_456"])
gemini_analyze_url(url="https://youtube.com/watch?v=...", prompt="О чём это видео?")
gemini_upload_file(file_path="/path/to/doc.pdf", prompt="Сделай краткое резюме")

致谢

许可证

AGPL-3.0 -自由使用、修改和分发，前提是源代码保持开放。

______________________________________________________________________

gemini-webapi-mcp

MCP server for Google Gemini — image generation/editing, chat and file analysis via browser cookies.

No API keys. Free.

______________________________________________________________________

特性

• 图像生成 来自文本描述（支持宽高比的Nano Banana 2）
• 2倍分辨率 --自动下载升级版本（2048x2048→ 2816x1536及以上）
• 图像编辑 --发送图像+提示以获取修改后的版本
• 文件分析 --视频、图像、PDF、文档
• 文本聊天 与双子座（闪光、专业、闪光思维）
• 自动水印删除 --使用反向阿尔法混合无损去除闪光痕迹
• 自动身份验证 通过Chrome浏览器Cookie

快速开始

1.登录Gemini

打开Chrome浏览器，转到 gemini.google.com 并登录。

2.安装MCP服务器

来自GitHub（无需克隆）：

uv run --with "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git" gemini-webapi-mcp

本地安装：

git clone https://github.com/AndyShaman/gemini-webapi-mcp.git
cd gemini-webapi-mcp
uv sync
uv run gemini-webapi-mcp

3.添加MCP配置

Claude Code

claude mcp add-json gemini '{"command":"uv","args":["run","--with","gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git","gemini-webapi-mcp"]}'

或手动添加到 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "gemini": {
      "command": "uv",
      "args": ["run", "--with", "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git", "gemini-webapi-mcp"]
    }
  }
}

Claude Desktop

添加到Claude桌面配置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gemini": {
      "command": "uv",
      "args": ["run", "--with", "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git", "gemini-webapi-mcp"]
    }
  }
}

Other MCP clients

使用标准MCP stdio配置：

{
  "mcpServers": {
    "gemini": {
      "command": "uv",
      "args": ["run", "--with", "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git", "gemini-webapi-mcp"]
    }
  }
}

配置文件路径取决于您的MCP客户端。

Local install (after cloning) — replace args with:

"args": ["--directory", "/path/to/gemini-webapi-mcp", "run", "gemini-webapi-mcp"]

4.安装克劳德代码技能（可选）

这 skill/ 该文件夹包含一个Claude Code技能——提示提示提示、工具文档和图像生成指南。与双子座合作时，该技能会自动激活。

cp -r skill ~/.claude/skills/gemini-mcp

5.验证

手动运行服务器——如果它初始化时没有错误，一切正常：

uv run --with "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git" gemini-webapi-mcp

然后打开Claude Code或Claude Desktop并尝试： *“用Gemini生成水彩猫图像”*.

认证

服务器通过以下方式自动从Chrome读取Cookie browser-cookie3.

多个谷歌账号？ 集 GEMINI_ACCOUNT_INDEX --Chrome的账号（0=第一个，1=第二个，…）。点击gemini.google.com上的头像查看订单。

如果cookie自动检测失败，请手动设置：

1. 在gemini.google.com上打开Chrome DevTools→ 应用→ Cookie
2. 复制 __Secure-1PSID 和 __Secure-1PSIDTS 价值观
3. 添加到MCP配置中：

{
  "mcpServers": {
    "gemini": {
      "command": "uv",
      "args": ["run", "--with", "gemini-webapi-mcp @ git+https://github.com/AndyShaman/gemini-webapi-mcp.git", "gemini-webapi-mcp"],
      "env": {
        "GEMINI_PSID": "your__Secure-1PSID_value",
        "GEMINI_PSIDTS": "your__Secure-1PSIDTS_value"
      }
    }
  }
}

环境变量

高分辨率（2x）

服务器会自动请求每个生成图像的升级版本，这与Gemini web界面中的“下载”按钮使用的机制相同。谷歌执行服务器端升级，以2倍分辨率提供图像：

如果2x版本不可用（超时、网络错误），服务器会自动回退到本机分辨率。

水印去除

Gemini在生成的图像的右下角添加了一个闪亮的水印（4点星形）。服务器使用自动删除它 反向阿尔法混合 算法——原始像素值的数学无损恢复。无需额外的依赖关系或模型下载。

工具

模型

用法示例

配置后，Claude会自动调用正确的工具。只需在聊天中提问：

克劳德将调用的工具：

gemini_generate_image(prompt="a cat in watercolor style")
gemini_generate_image(prompt="make it gray", files=["/path/to/cat.png"])
gemini_generate_image(prompt="make the background darker", conversation_id=["c_abc", "r_123", "rc_456"])
gemini_analyze_url(url="https://youtube.com/watch?v=...", prompt="Summarize this video")
gemini_upload_file(file_path="/path/to/doc.pdf", prompt="Summarize key points")

致谢

许可证

AGPL-3.0 --只要源代码保持开放，就可以免费使用、修改和分发。