ConsoleSun/Gemini-Eyes

README 摘要

gemini-web-mcp 让 Agent 用上 Gemini 的「眼睛」和「手」 —— 一个 MCP 服务，把 gemini.google.com 网页端的能力桥接给任何 Agent： - 🗣️ 对话 ：多轮聊天、续聊历史会话 - 👁️ 看图 / 看视频 ：上传本地文件，让 Gemini 识别并描述 - 🎨 生图（Imagen）/ 🎬 生视频（Veo） ：自动下载成品到本地 - 💬 会话管理 ：列出 / 读取 / 删除账号下的历史对话 - 🔄 免维护登录态 ：后台每 25 分钟自动续期 Cookie，服务常驻就不过期 核心特点 ：不走官方 API—— 不需要 API Key、不产生 API 计费 。它复用你浏览器里 已登录的 Google 会话 Cookie，重放网页端的内部请求，与你在浏览器里使用完全等价 （共享账号历史、共享生成额度）。 ⚠️ 风险提示 本项目是对 Gemini 网页端内部接口的逆向封装，非官方 API；自动化访问可能违反 Google 服务条款，请合法使用、自行评估风险。 请务必使用专用 Google 小号测试， 不要使用主力账号 ——这类操作有真实的封号风险，且不应用于商业用途或批量抓取。 快速开始 环境：Python ≥ 3.10，推荐 uv。 1. 准备 Cookie（二选一） A. 自动提取 ：在 Chrome/Edge 登录 gemini.google.com 后 关闭浏览器 ： 新版浏览器改用 portal/app-bound 加密无法离线解密时，程序会明确提示，改用方式 B。 B. 手动导出 ：用浏览器扩展（如 Cookie-Editor）导出 gemini.google.com 的全部 Cookie 为 JSON。 全量导出、一个不落 ；其中 Secure-1PSID 必带，浏览器里有 Secure-1PSIDTS 则必须一起带。保存位置三选一： - 默认路径 /.config/gemini-web-mcp/cookies.json —— 服务自动读取，零配置 - 任意路径 + 启动参数 --cookie-file /path/to/cookies.json - 任意路径 + 环境变量 GEMINI COOKIE FILE 2. 启动服务 3. 接入客户端 DeepSeek Harness（推荐） ：仓库根目录带有 DSH bundle 清单， 开箱即用 ——不设 环境变量时走「 uv + Chrome 自动提取 Cookie」的零配置路径；需要自定义时，在启动 dsh web 前设置环境变量（任选）： - GEMINI EYES UV —— uv 的绝对路径（默认：PATH 上的 uv ） - GEMINI EYES DIR —— 本仓库的绝对路径（默认：dsh 的当前工作目录） - GEMINI CO…

分类