Skip to content
Back to search

KenEasy-Gemini-MCP-Auto-Helper

Google Gemini MCP 自动化放行与连续对话助手:MV3 永不断线后台引擎 + 智能点击重试,自动点击「始终允许」与「继续/Yes」、4 语言黑白双模式、零飞角自由拖拽悬浮窗、超时桌面通知及 6 层防刷熔断保护。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ngiken--keneasy-gemini-mcp-auto-helper/badge.svg)](/listings/ngiken--keneasy-gemini-mcp-auto-helper)

HTML

<a href="/listings/ngiken--keneasy-gemini-mcp-auto-helper"><img src="/api/listings/ngiken--keneasy-gemini-mcp-auto-helper/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Option 1: Chrome Web Store (Pending Review)

The extension has been submitted for Chrome Web Store security review. Once approved, you can install and receive silent auto-updates with one click:

👉 **[Get KenEasy Gemini MCP Auto Helper on Chrome Web Store (Coming Soon)](https://chromewebstore.google.com/)**

Option 2: Manual Installation (Developer Mode - One-Click Direct Download)

Click either link below to **immediately download the `.zip` package with one click**:

- 📦 **[Direct Download: Manual Install Bundle (`KenEasy-Gemini-MCP-Auto-Helper-v0.3.0-manual-install.zip`)](https://github.com/ngiken/KenEasy-Gemini-MCP-Auto-Helper/releases/download/v0.3.0/KenEasy-Gemini-MCP-Auto-Helper-v0.3.0-manual-install.zip)** (Recommended — extracts to `KenEasy-Gemini-MCP-Auto-Helper/` folder with docs) - 🏪 **[Direct Download: Clean Extension Zip (`KenEasy-Gemini-MCP-Auto-Helper-v0.3.0-store.zip`)](https://github.com/ngiken/KenEasy-Gemini-MCP-Auto-Helper/releases/download/v0.3.0/KenEasy-Gemini-MCP-Auto-Helper-v0.3.0-store.zip)** (Clean root containing `manifest.json`)

Installation steps: 1. Click a link above to download the `.zip` file and extract it into your local directory (e.g. `E:\code\KenEasy-Gemini-MCP-Auto-Helper`). 3. Open Google Chrome or Microsoft Edge and navigate to: - **Chrome**: `chrome://extensions/` - **Edge**: `edge://extensions/` 4. Enable the **Developer mode** toggle in the top-right corner. 5. Click the **Load unpacked** button in the top-left toolbar. 6. In the folder picker dialog, select the repository root directory containing `manifest.json`. 7. Open or refresh [Google Gemini](https://gemini.google.com/). You will see the floating HUD on the page, and clicking the extension toolbar icon opens the full configuration panel.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 241 lines
  1. <div align="center">
  2. <img src="assets/hero-banner.png" alt="KenEasy Gemini MCP Auto Helper" width="100%">
  3. <h1>KenEasy Gemini MCP Auto Helper</h1>
  4. <p>
  5. An intelligent automation extension tailored for <b>Google Gemini</b> web UI: auto-approves MCP tool permissions with "Always allow", auto-clicks "Continue / Yes" follow-up chips, supports <b>4 languages (简体/繁體/EN/日本語)</b> and <b>Dark/Light theme modes</b>, features a hold-to-drag floating HUD, one-click desktop notifications, multi-window &amp; non-chat guards, and a 6-layer anti-loop circuit breaker.
  6. </p>
  7. <p>
  8. English · <a href="README.zh-CN.md">简体中文</a>
  9. ·
  10. <a href="CHANGELOG.md">Changelog</a>
  11. ·
  12. <a href="https://github.com/ngiken/KenEasy-Gemini-MCP-Auto-Helper/issues">Issues / Feedback</a>
  13. </p>
  14. <p>
  15. <img alt="Version" src="https://img.shields.io/badge/version-v0.3_Beta-3b82f6?logo=googlechrome&logoColor=white">
  16. <img alt="Chrome Web Store" src="https://img.shields.io/badge/Chrome_Web_Store-Pending_Review-4285F4?logo=googlechrome&logoColor=white">
  17. <img alt="Manifest" src="https://img.shields.io/badge/manifest-v3-00aeec">
  18. <img alt="License" src="https://img.shields.io/badge/license-MIT-27c499">
  19. </p>
  20. </div>
  21. > [!WARNING]
  22. > ### ⚠️ Beta Release Notice (v0.3 Beta Preview)
  23. > This extension is currently in **Public Beta Preview (v0.3 Beta)**.
  24. > While the core automation engine, 6-layer circuit breaker, hold-to-drag HUD, multi-language &amp; dark/light themes, multi-window guards, and desktop notification subsystems have passed 100% of the automated & VM end-to-end test suites (64/64), Google Gemini (`gemini.google.com`) continuously updates its Material Web Components and DOM layouts.
  25. > - If you encounter unrecognized confirmation dialogs or unexpected behavior, please submit feedback or screenshots on [GitHub Issues](https://github.com/ngiken/KenEasy-Gemini-MCP-Auto-Helper/issues), or add custom terms in the "Custom Keywords" section of the popup settings.
  26. > - Star 🌟 and PR contributions are warmly welcomed!
  27. ---
  28. ## 🚀 Installation
  29. ### Option 1: Chrome Web Store (Pending Review)
  30. The extension has been submitted for Chrome Web Store security review. Once approved, you can install and receive silent auto-updates with one click:
  31. 👉 **[Get KenEasy Gemini MCP Auto Helper on Chrome Web Store (Coming Soon)](https://chromewebstore.google.com/)**
  32. ### Option 2: Manual Installation (Developer Mode - One-Click Direct Download)
  33. Click either link below to **immediately download the `.zip` package with one click**:
  34. - 📦 **[Direct Download: Manual Install Bundle (`KenEasy-Gemini-MCP-Auto-Helper-v0.3.0-manual-install.zip`)](https://github.com/ngiken/KenEasy-Gemini-MCP-Auto-Helper/releases/download/v0.3.0/KenEasy-Gemini-MCP-Auto-Helper-v0.3.0-manual-install.zip)** (Recommended — extracts to `KenEasy-Gemini-MCP-Auto-Helper/` folder with docs)
  35. - 🏪 **[Direct Download: Clean Extension Zip (`KenEasy-Gemini-MCP-Auto-Helper-v0.3.0-store.zip`)](https://github.com/ngiken/KenEasy-Gemini-MCP-Auto-Helper/releases/download/v0.3.0/KenEasy-Gemini-MCP-Auto-Helper-v0.3.0-store.zip)** (Clean root containing `manifest.json`)
  36. Installation steps:
  37. 1. Click a link above to download the `.zip` file and extract it into your local directory (e.g. `E:\code\KenEasy-Gemini-MCP-Auto-Helper`).
  38. 3. Open Google Chrome or Microsoft Edge and navigate to:
  39. - **Chrome**: `chrome://extensions/`
  40. - **Edge**: `edge://extensions/`
  41. 4. Enable the **Developer mode** toggle in the top-right corner.
  42. 5. Click the **Load unpacked** button in the top-left toolbar.
  43. 6. In the folder picker dialog, select the repository root directory containing `manifest.json`.
  44. 7. Open or refresh [Google Gemini](https://gemini.google.com/). You will see the floating HUD on the page, and clicking the extension toolbar icon opens the full configuration panel.
  45. ---
  46. ## 🎬 Core Features Walkthrough & Demos (v0.3 Highlights)
  47. ### 1. Hold-to-Drag Floating HUD (Hover-Sticking Fixed) 🆕
  48. > Left-click and hold the HUD header to drag it smoothly anywhere across the Gemini viewport — simply hovering near the header never moves or traps the HUD! Features deferred pointer capture beyond the 4px movement deadzone, independent header buttons for minimize/theme/language, off-window auto-release, viewport clamping, and one-click position reset in the popup.
  49. <div align="center">
  50. <img src="assets/hud-drag-demo.png" alt="Hold-to-Drag Floating HUD Demo" width="100%">
  51. </div>
  52. ### 2. One-Click Desktop Notification & Anti-Stall Alert
  53. > If an MCP tool execution hangs or model output stalls longer than the configured threshold (default 5 minutes), the extension triggers a localized OS desktop notification and flags a red `!` badge on the toolbar icon. Easily mute or enable with a single click directly from the on-page HUD or the popup. Clicking the notification instantly brings the Gemini tab and window back to the foreground.
  54. <div align="center">
  55. <img src="assets/notification-toggle-demo.png" alt="One-Click Desktop Notification Demo" width="100%">
  56. </div>
  57. ### 3. Dark & Light Dual Themes + 4-Language Control Center (Popup Overview) 🆕
  58. > Switch effortlessly between **Dark Night** and **Light Daylight** themes (`🌙 / ☀️`) and across **4 languages (`简体中文 / 繁體中文 / English / 日本語`)** in real time from either the popup or HUD. Includes live stats, 6-layer circuit breakers, notification testing, HUD position reset, and emergency kill switch.
  59. <div align="center">
  60. <img src="assets/popup-demo.png" alt="Extension Popup Overview" width="100%">
  61. </div>
  62. ---
  63. ## ⚡ Capability Matrix
  64. | Category | Feature | Technical Breakdown |
  65. | :--- | :--- | :--- |
  66. | **MCP Auto-Approval** | Always Allow Priority | Prefers and auto-clicks `Always allow / 始终允许`, penetrating Material Web Components `<slot>` projections and `role="menu"` / `role="menuitem"` dropdown options. |
  67. | **Single Allow Fallback** | Safe Single Click | Optional fallback to click `Allow once / 仅允许一次` when no "Always allow" option exists, strictly guarded by sibling context checks. |
  68. | **Smart Continuity** | Follow-up Chip Click | Detects and triggers explicit affirmative `↪ Yes` follow-up chips and "Continue" buttons, strictly ignoring general suggestions, surveys, and chat history. |
  69. | **Hold-to-Drag Floating HUD** 🆕 | Left-Button Press Guard | Requires an active left-button hold on the header to drag (zero hover-sticking); independent header buttons for collapse, theme, and language, plus popup Reset HUD button. |
  70. | **Multi-Language & Dual Theme** 🆕 | 4 Locales + Dark/Light | Live switching across `简体中文`, `繁體中文`, `English`, and `日本語` (including Japanese/Cantonese keywords) and crisp Dark / Light UI modes synced across HUD & popup. |
  71. | **Multi-Window & Route Guard** 🆕 | Zero Accidental Clicks | Skips non-chat routes (`/gems`, `/extensions`, `/settings`), 0-turn screens, and stale history chips on restored tabs in secondary browser windows. |
  72. | **Desktop Notifications** | One-Click Anti-Stall Alert | Issues localized desktop notifications when MCP execution exceeds the stall threshold (1–60 mins); togglable instantly from either the HUD or the popup. |
  73. | **Background Persistence** | Uninterrupted Execution | MV3 Service Worker keeps Gemini active in minimized or background tabs via long-lived connection ports and `chrome.alarms` heartbeats. |
  74. | **Tab Discard Protection** | Anti-Memory-Saver Sleep | Sets `autoDiscardable: false` on active Gemini tabs to prevent Chrome Memory Saver from unloading the page. |
  75. | **6-Layer Circuit Breaker** | Anti-Loop Quota Guard | Enforces per-task limits, daily limits, streaming stabilization settle time, operation cooldown, completion cues, and stagnant output detection. |
  76. | **Custom Keywords** | Flexible Word Matching | Extend built-in dictionaries with customized comma- or newline-separated keyword phrases for approval and continuation. |
  77. | **Emergency Kill Switch** | Instant Safe Brake | Prominent "Emergency Stop" button instantly blocks all automation actions; includes "Reset Breaker" and "Reset Stats" controls. |
  78. ---
  79. ## 🛡️ 6-Layer Anti-Loop Circuit Breaker Architecture
  80. To safeguard your API quotas and tokens against runaway recursive loops, the extension implements a comprehensive multi-tier circuit breaker:
  81. ```text
  82. ┌────────────────────────────────────────────────────────┐
  83. │ Gemini Output & DOM Mutation Stream │
  84. └──────────────────────────┬─────────────────────────────┘
  85. │
  86. ▼ Layer A: Quota & Error Breaker (Immediate Trip)
  87. [ "Reached your limit" / "Quota exceeded" / "Try again later" ] ──► 🚨 Hard Stop
  88. │
  89. ▼ Layer B: Streaming Settle Guard (Wait for Completion)
  90. [ Observe DOM until stable with no cursor for >= 1.8s ]
  91. │
  92. ▼ Layer C: Operation Cooldown Guard (Rate Limiting)
  93. [ Force minimum 3.0s delay after every "Continue" action ]
  94. │
  95. ▼ Layer D: Per-Task Continue Limit (Single Prompt Guard)
  96. [ Max continues reached (default 10) ] ──► 🛑 Per-Task Trip
  97. │
  98. ▼ Layer E: Daily Continue Cap (All-Day Safety Net)
  99. [ Daily cap reached (default 0=unlimited) ] ──► 🛑 Daily Trip
  100. │
  101. ▼ Layer F: Completion Cue & Smart Pass-Through
  102. [ "Task completed" found & no explicit ↪ Yes chip ] ──► ⏹️ Skip Action
  103. │
  104. ▼ Layer G: Stagnant Output & Repetition Detection
  105. [ Output DOM unchanged or identical text across turns ] ──► ⚠️ Stagnant Trip
  106. ```
  107. 1. **Layer A · Quota & Error Cutoff**: Instantly halts all automated actions when Gemini outputs error phrases such as `reached your limit`, `quota exceeded`, `please try again later`, or system service errors.
  108. 2. **Layer B · Streaming Settle Guard (default 1.8s)**: Observes streaming output to verify the blinking cursor is gone and no DOM updates have occurred for at least 1.8 seconds before taking any action.
  109. 3. **Layer C · Operation Cooldown (default 3.0s)**: Enforces an intentional pause between consecutive clicks to prevent double-click race conditions.
  110. 4. **Layer D · Per-Task Limit (default 10)**: Limits continues per conversation turn; automatically resets to 0 whenever the user sends a new prompt.
  111. 5. **Layer E · Daily Continue Cap (default 0 = unlimited)**: Caps total automated continues per calendar day, automatically resetting at midnight (00:00).
  112. 6. **Layer F · Completion Cue Detection**: Skips auto-continue when Gemini outputs definitive completion phrases like "All tasks finished", while smartly continuing if Gemini explicitly displays a `↪ Yes` follow-up chip.
  113. 7. **Layer G · Stagnant Output Fingerprinting**: Trips when consecutive actions produce zero new content or generate identical response hashes, preventing repetitive bot loops.
  114. ---
  115. ## 🏗️ Architecture & Decoupled Modules
  116. The extension follows clean separation of concerns and data-driven principles:
  117. ```text
  118. manifest.json
  119. Manifest V3 declaration specifying minimal permissions (storage, tabs, alarms, scripting, notifications) and Gemini matching rules.
  120. defaults.js
  121. Shared configuration hub: built-in keyword dictionaries, default options, schema migration, and boundary clamping.
  122. hud.js & hud.css
  123. In-page floating HUD component: pointer drag handling, boundary clamping, live state pills, and quick notification toggle.
  124. content.js
  125. Runs in the isolated content script world: DOM observers, button matching heuristics, circuit breakers, and microtask dispatchers.
  126. background.js
  127. Persistent Service Worker: manages long-lived ports, heartbeat alarms, tab discard prevention, and OS desktop notifications.
  128. popup.js, popup.html, popup.css
  129. Extension popup control center: real-time metrics, interactive switches, custom keywords textarea, and emergency controls.
  130. ```
  131. ---
  132. ## ❓ Frequently Asked Questions (FAQ)
  133. <details>
  134. <summary><b>Q1: Why is the floating HUD not appearing on the Gemini page?</b></summary>
  135. 1. Confirm that your browser is on a page matching `https://gemini.google.com/*`.
  136. 2. Click the extension toolbar icon and ensure that the Master Switch and "Show floating HUD" options are enabled.
  137. 3. If the HUD was previously dragged off-screen, click "Save Settings" in the popup to re-clamp it to the visible viewport.
  138. </details>
  139. <details>
  140. <summary><b>Q2: Does the draggable HUD remember its position after refreshing the page?</b></summary>
  141. Yes. When you release the HUD after dragging, its `(left, top)` coordinates are immediately saved to LocalStorage (`gmah_hud_position`). It will restore to your chosen location across page reloads and new chat sessions.
  142. </details>
  143. <details>
  144. <summary><b>Q3: Why did I not receive a desktop notification when execution stalled?</b></summary>
  145. 1. Open the popup and click the **"Test Notification"** button to confirm that your browser and operating system have notification permissions enabled.
  146. 2. Check if Windows "Focus Assist" or macOS "Do Not Disturb" is active.
  147. 3. Verify that the "Desktop Notification" pill in the HUD or the toggle in the popup is turned on.
  148. </details>
  149. <details>
  150. <summary><b>Q4: Will the extension accidentally click "Delete Chat" or "Deny"?</b></summary>
  151. No. The engine applies an explicit exclusion blacklist (blocking terms like delete, remove, deny, cancel, dismiss, survey) combined with strict sibling hierarchy and container verification.
  152. </details>
  153. <details>
  154. <summary><b>Q5: How do I restore default settings?</b></summary>
  155. Click the **"Restore Defaults"** button at the bottom of the extension popup. This resets all thresholds, cooldowns, and keyword sets to safe official defaults.
  156. </details>
  157. ---
  158. ## 📝 Changelog
  159. ### [v0.3.0 (v0.3 Beta)](https://github.com/ngiken/KenEasy-Gemini-MCP-Auto-Helper/releases/tag/v0.3.0) - 2026-11-22
  160. - **Never-Sleep MV3 Background Engine**: Added ~19.5s Service Worker keepalive, proactive 4-minute Port rotation before Chrome's 5-minute disconnect limit, unthrottled SW delayed settling/cooldown ticks (`GMAH_SCHEDULE_TICK`), and instant tab/window focus wakeups so automation never stalls in background or other apps.
  161. - **Smart Background Click Retry & Shadow DOM Observer**: Auto-retries un-dismissed clicks in background with `@material/web` ShadowRoot inner `<button>` piercing and safe focus/coords; recursively observes dynamic ShadowRoots; fixes minimized-window hidden spinners falsely locking `isGenerating`.
  162. - **Zero-Glitch HUD, Popup & Safety Hardening**: Stops Windows minimize (`0x0` resize) from snapping the HUD to `(0, 0)`, auto-clamps on expand/panel open, fixes `/app` -> `/app/<id>` new-chat continue suppression, guards cookies/notifications/camera/mic/location across all 4 locales, adds live 4-language engine status, and auto-saves popup fields with instant breaker reconciliation.
  163. - **64/64 Automated, E2E Sandbox & 30-Min Marathon Tests**: Verified end-to-end across 5 test suites including a 30-minute hidden background marathon with 7+ port rotations and simulated SW crash recovery.
  164. ### [v0.2.0 (v0.2 Beta)](https://github.com/ngiken/KenEasy-Gemini-MCP-Auto-Helper/releases/tag/v0.2.0) - 2026-11-22
  165. - **Hold-to-Drag HUD Fix**: Strict left-button press gating (`isPointerDown`) eliminates hover-sticking; deferred pointer capture after 4px threshold keeps collapse, theme, and language header buttons immediately responsive; added off-window auto-release and popup **Reset HUD** button.
  166. - **Multi-Window & Non-Chat Guard**: Skips non-chat routes (`/gems`, `/extensions`, `/settings`, etc.) and 0-turn screens; removed overly broad `'开始'`/`'開始'` triggers; ignores stale pre-existing history chips on restored tabs in secondary browser windows.
  167. - **4-Language Support**: Live UI, desktop notification, and keyword recognition across `简体中文`, `繁體中文`, `English`, and `日本語`.
  168. - **Dark & Light Dual Themes**: Synchronized Dark Night (`🌙`) and Light Daylight (`☀️`) modes across both the floating HUD and extension popup.
  169. - **Redesigned 2x Retina Assets**: All promotional banners, walkthrough diagrams, and Chrome Web Store screenshots rebuilt at 2x DPI.
  170. ### [v0.1.0 (v0.1 Beta)](https://github.com/ngiken/KenEasy-Gemini-MCP-Auto-Helper/releases/tag/v0.1.0) - 2026-11-21
  171. - Initial Public Beta release with MCP "Always allow" auto-approval, `↪ Yes` follow-up chip clicking, draggable floating HUD, 1-click desktop stall notifications, background keep-alive, and 6-layer anti-loop circuit breaker.
  172. See full details in [CHANGELOG.md](CHANGELOG.md).
  173. ---
  174. ## Friendly Links
  175. - [LINUX DO](https://linux.do) - Sincere, friendly, collaborative, and professional developer community.
  176. ---
  177. ## License
  178. This project is licensed under the [MIT License](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.