ghost-bridge 0.3.0 → 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 <Author>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,85 +1,159 @@
-# Ghost Bridge（Claude MCP 无重启调试桥）
+# 👻 Ghost Bridge
 
-> 目标：在日常 Chrome 内零启动参数附加 DevTools，面向线上压缩代码（无 sourcemap）快速定位。
+[![npm version](https://img.shields.io/npm/v/ghost-bridge.svg?style=flat-square)](https://www.npmjs.com/package/ghost-bridge)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 
-## 目录结构
-- `server.js`：MCP server，通过 stdio 被 Claude CLI 拉起，与扩展用 WebSocket 通信
-- `extension/`：Chrome MV3 扩展，使用 `chrome.debugger` 附加当前激活标签
+> **Zero-restart Chrome AI Copilot** — Subvert your workflow. Allow AI to seamlessly take over the browser you're already using, enabling real-time debugging, visual observation, and interactive manipulation without launching a new Chrome instance.
 
-# Ghost Bridge（Claude MCP 无重启调试桥）
+---
+
+## ✨ Why Ghost Bridge?
 
-> 目标：在日常 Chrome 内零启动参数附加 DevTools，面向线上压缩代码（无 sourcemap）快速定位。
+- 🔌 **Zero-Config Attach** — Bypasses the need for `--remote-debugging-port`. Captures Chrome's native DevTools Protocol directly via an extension.
+- 🔍 **No-Sourcemap Debugging** — Slice code fragments, perform string searches, and analyze coverage to pinpoint bugs straight in minified production code.
+- 🌐 **Deep Network Analysis** — Comprehensive capture of requests/responses with multi-dimensional filtering and response body inspection.
+- 📸 **Visual & Structural Perception** — Full-page or clipped high-fidelity screenshots paired with structural data extraction (titles, links, forms, buttons).
+- 🎯 **DOM Physical Manipulation** — Empowers AI to click, type, and form-submit with CDP-level physical simulation. Fully compatible with complex SPAs (React/Vue/Angular/Svelte).
+- 📊 **Performance Diagnostics** — Get granular engine metrics: JS Heap, Layout recalculations, Web Vitals (TTFB/FCP/LCP), and resource loading speeds.
+- 🔄 **Multi-Client Mastery** — Built-in singleton manager automatically coordinates multiple MCP clients sharing a single Chrome transport.
 
-## 快速使用
+---
 
-### 1. 安装與初始化
+## 🚀 Quick Start
+
+### 1. Install & Initialize
 
 ```bash
-# 全局安装
+# Install globally
 npm install -g ghost-bridge
 
-# 自动配置 Claude MCP 并准备扩展
+# Auto-configure MCP (Claude Code, Antigravity, Codex) and prepare the extension directory
 ghost-bridge init
 ```
 
-### 2. 加载 Chrome 扩展
+> **Note on other MCP clients (Cursor, Windsurf, Roo):** 
+> `ghost-bridge init` attempts to auto-configure supported clients. If your client isn't auto-detected, simply add the following to your client's MCP configuration file (e.g., `mcp.json`):
+> ```json
+> {
+>   "mcpServers": {
+>     "ghost-bridge": {
+>       "command": "node",
+>       "args": ["/absolute/path/to/global/node_modules/ghost-bridge/dist/server.js"]
+>     }
+>   }
+> }
+> ```
+
+### 2. Load the Chrome Extension
+
+1. Open Chrome and navigate to `chrome://extensions`
+2. Toggle **Developer mode** in the top right corner.
+3. Click **Load unpacked**
+4. Select the directory: `~/.ghost-bridge/extension`
+
+> 💡 *Tip: Run `ghost-bridge extension --open` to reveal the directory directly.*
+
+### 3. Connect & Command
+
+1. Click the **Ghost Bridge** ghost icon in your browser toolbar.
+2. Click **Connect** and wait for the status to turn to ✅ **ON**.
+3. Open Claude Desktop or your Claude CLI. All tools are now primed and ready!
+
+---
+
+## 🛠️ Tool Arsenal
+
+### 🔍 Core Debugging
+
+| Tool | Capability |
+|------|------------|
+| `get_server_info` | Retrieves server instance status, WebSocket ports, and client roles. |
+| `get_last_error` | Aggregates recent exceptions, console errors, and failed network requests with mapped locators. |
+| `get_script_source` | Pulls raw script definitions. Supports URL-fragment filtering, specific line targeting, and beautification. |
+| `coverage_snapshot` | Triggers a quick coverage trace (1.5s default) to identify the most active scripts on the page. |
+| `find_by_string` | Scans page script sources for keywords, returning a 200-character context window. |
+| `symbolic_hints` | Gathers context clues: Resource lists, Global Variable keys, LocalStorage schema, and UA strings. |
+| `eval_script` | Executes raw JavaScript expressions in the page context. *(Use with caution)* |
+
+### 🌍 Network Intelligence
+
+| Tool | Capability |
+|------|------------|
+| `list_network_requests` | Lists captured network traffic. Supports filtering by URL, Method, Status Code, or Resource Type. |
+| `get_network_detail` | Dives deep into a specific request's Headers, Timing, and optional Response Body extraction. |
+| `clear_network_requests` | Wipes the current network capture buffer. |
+
+### 📸 Page Perception
+
+| Tool | Capability |
+|------|------------|
+| `capture_screenshot` | Captures the viewport or emulates full-page scrolling screenshots. |
+| `get_page_content` | Extracts raw text, sanitized HTML, or structured actionable data representations. |
+
+### 🎯 Interactive Automation (DOM)
+
+| Tool | Capability |
+|------|------------|
+| `get_interactive_snapshot` | Scans for visible interactive elements, returning a concise map `[e1, e2...]`. Pierces open Shadow DOMs. |
+| `dispatch_action` | Dispatches physical UI actions (click, fill, press, hover) against targeted element references (e.g., `e1`). |
+
+**Example Agent Workflow:**
+1. AI: `get_interactive_snapshot` ➝ `[{ref:"e1", tag:"input", placeholder:"Search..."}, {ref:"e2", tag:"button", text:"Login"}]`
+2. AI: `dispatch_action({ref: "e1", action: "fill", value: "hello"})`
+3. AI: `dispatch_action({ref: "e2", action: "click"})`
+4. AI: `capture_screenshot` to verify state changes.
+
+### 📊 Performance Profiling
+
+| Tool | Capability |
+|------|------------|
+| `perf_metrics` | Collects layered performance data (Engine Metrics, Web Vitals, and Resource Load Summaries). |
+
+---
+
+## ⚙️ Configuration
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| **Base Port** | `33333` | WS port. Auto-increments if occupied. |
+| **Token** | *Monthly UUID* | Local WS auth token, auto-rotates on the 1st of every month. |
+| **Auto Detach** | `false` | Keeps debugger attached to actively buffer invisible exceptions and network calls. |
+
+**Environment Variables:**
+- `GHOST_BRIDGE_PORT` — Override base port.
+- `GHOST_BRIDGE_TOKEN` — Override connection token.
+
+---
+
+## 🏗️ Architecture
+
+```mermaid
+graph LR
+    A[Claude CLI/Desktop] <-->|stdio| B(MCP Server\nserver.js)
+    B <-->|WebSocket| C(Chrome Extension\nbackground.js)
+    C <-->|CDP| D[Browser Tab\nTarget Context]
+```
+
+- **MCP Server**: Spawned by Claude via standard I/O streams. Orchestrates WS connections.
+- **Chrome Extension (MV3)**: Taps into `chrome.debugger` API. Utilizes an Offscreen Document to prevent WS hibernation.
+- **Singleton Design**: If multiple agents spawn servers, the first becomes the master bridge while subsequent instances chain transparently as clients.
 
-1. 打开 Chrome，访问 `chrome://extensions`
-2. 开启右上角的“开发者模式”
-3. 点击“加载已解压的扩展程序”
-4. 选择目录：`~/.ghost-bridge/extension`
-   > 提示：运行 `ghost-bridge extension --open` 可直接打开该目录
+---
 
-### 3. 开始使用
+## ⚠️ Known Limitations
 
-启动 Claude Desktop 或 Claude CLI，Ghost Bridge 工具即可直接通过 MCP 调用。无需额外启动任何服务（MCP 会自动管理）。
+- **Service Workers Suspending**: MV3 background workers may suspend. We've built robust auto-reconnection logic, but prolonged inactivity might require re-toggling.
+- **DevTools Conflict**: If you manually open Chrome DevTools (F12) on the target tab, `chrome.debugger.attach` may be rejected.
+- **Beautify Overhead**: Beautifying massive single-line bundles is expensive; the server will auto-truncate overly large scripts.
+- **Cross-Origin OOPIF**: Elements and errors deeply embedded in strict Cross-Origin Iframes might evade the primary debugger hook without further multi-target attach logic.
 
 ---
 
-## 常用命令
-
-- `ghost-bridge init`: 配置 MCP 并复制扩展文件
-- `ghost-bridge status`: 检查配置状态
-- `ghost-bridge extension`: 显示扩展安装路径
-- `ghost-bridge start`: 手动启动 MCP 服务（通常不需要）
-
-## 默认配置
-- 端口：`3301`（`server.js` / `extension/background.js`）
-- token：`1`（仅用于本机 WS 校验，如需修改请保持两端一致）
-
-## 工具说明
-
-### 基础调试工具
-- **get_last_error**：汇总最近异常/console/网络报错，附带行列与脚本标识
-- **get_script_source**：支持 `scriptUrlContains`、`line`、`column`，返回源码片段（无 sourcemap 仍可用）
-- **coverage_snapshot**：默认 1.5s，输出调用次数最高的脚本
-- **find_by_string**：在脚本源码里按关键词搜索，返回上下文 200 字符窗口
-- **symbolic_hints**：采集资源列表、全局变量 key、localStorage key、UA 与 URL
-- **eval_script**：只读表达式执行；谨慎使用，避免改写页面状态
-
-### 🆕 网络请求分析工具
-- **list_network_requests**：列出捕获的网络请求
-  - 支持按 URL 关键词过滤（`filter`）
-  - 支持按请求方法过滤（`method`: GET/POST/PUT/DELETE）
-  - 支持按状态过滤（`status`: success/error/failed/pending）
-  - 支持按资源类型过滤（`resourceType`: XHR/Fetch/Script/Image）
-  - 返回：URL、方法、状态码、耗时、大小等摘要信息
-
-- **get_network_detail**：获取单个请求的详细信息
-  - 请求头和响应头
-  - 请求方法、状态码、MIME 类型
-  - 耗时分析（timing）
-  - 可选获取响应体（`includeBody: true`）
-
-- **clear_network_requests**：清空已捕获的网络请求记录
-
-## 设计取舍
-- 不依赖 `--remote-debugging-port`，完全通过扩展获取 CDP，满足"零重启"
-- 默认 `autoDetach=false` 保持附加，便于持续捕获异常和网络请求；可通过图标 OFF 立即解除调试
-- 无 sourcemap 时通过片段截取、字符串搜索与覆盖率提供线索
-- 网络请求完整记录，支持查看请求/响应详情和响应体
-
-## 已知限制
-- 扩展 service worker 可能被挂起，已内置 1s 重连策略；若长时间无流量需重新唤醒
-- 若目标页面自带 DevTools 打开，`chrome.debugger.attach` 可能失败，请关闭后重试
-- 大体积单行 bundle beautify 可能耗时，server 端对超长源码会只截取片段
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome! 
+Check out our [Contributing Guide](CONTRIBUTING.md) to get started building tools or improving the bridge.
+
+## 📄 License
+
+This project is [MIT](LICENSE) licensed.

package/dist/cli.js

@@ -5454,9 +5454,15 @@ var require_lib = __commonJS({
 import path from "path";
 import os2 from "os";
 import { fileURLToPath } from "url";
-function getClaudeConfigPath() {
+function getClientConfigPaths() {
   const homeDir = os2.homedir();
-  return path.join(homeDir, ".claude.json");
+  return [
+    { name: "Claude Code", path: path.join(homeDir, ".claude.json") },
+    { name: "Antigravity", path: path.join(homeDir, ".gemini", "antigravity", "mcp.json") },
+    // Codex config placeholder - exact path depends on how Codex stores user config.
+    // Assuming a common pattern here like ~/.codex/mcp.json or similar.
+    { name: "Codex", path: path.join(homeDir, ".codex", "mcp.json") }
+  ];
 }
 function getExtensionPath() {
   const __filename2 = fileURLToPath(import.meta.url);
@@ -5502,20 +5508,28 @@ function openFolder(folderPath) {
 }
 async function init(options) {
   console.log(source_default.bold("\u{1F47B} Ghost Bridge Initialization"));
-  const configPath = getClaudeConfigPath();
+  const clientConfigs = getClientConfigPaths();
   const serverPath = getServerPath();
   const isDryRun = options.dryRun;
-  console.log(source_default.dim("Checking Claude configuration..."));
-  if (isDryRun) {
-    console.log(source_default.yellow(`[Dry Run] Would check config at: ${configPath}`));
-    console.log(source_default.yellow(`[Dry Run] Would add MCP server pointing to: ${serverPath}`));
-  } else {
-    if (!import_fs_extra.default.existsSync(configPath)) {
-      console.log(source_default.yellow(`Configuration file not found at ${configPath}, creating/skipping...`));
+  console.log(source_default.dim("Checking MCP Client configurations..."));
+  let configuredCount = 0;
+  for (const client of clientConfigs) {
+    const configPath = client.path;
+    if (isDryRun) {
+      console.log(source_default.yellow(`[Dry Run] Would check ${client.name} config at: ${configPath}`));
+      if (import_fs_extra.default.existsSync(configPath) || client.name === "Claude Code") {
+        console.log(source_default.yellow(`[Dry Run] Would add MCP server logic for ${client.name}`));
+      }
+      continue;
+    }
+    const exists = import_fs_extra.default.existsSync(configPath);
+    if (!exists && client.name !== "Claude Code") {
+      continue;
+    }
+    if (!exists) {
+      console.log(source_default.yellow(`Configuration file not found for ${client.name} at ${configPath}, creating...`));
       await import_fs_extra.default.ensureDir(path2.dirname(configPath));
-      if (!import_fs_extra.default.existsSync(configPath)) {
-        await import_fs_extra.default.writeJson(configPath, { mcpServers: {} }, { spaces: 2 });
-      }
+      await import_fs_extra.default.writeJson(configPath, { mcpServers: {} }, { spaces: 2 });
     }
     try {
       const config = await import_fs_extra.default.readJson(configPath);
@@ -5525,11 +5539,15 @@ async function init(options) {
         args: [serverPath]
       };
       await import_fs_extra.default.writeJson(configPath, config, { spaces: 2 });
-      console.log(source_default.green(`\u2705 MCP Server 'ghost-bridge' configured in ${configPath}`));
+      console.log(source_default.green(`\u2705 MCP Server configured for ${source_default.bold(client.name)} in ${configPath}`));
+      configuredCount++;
     } catch (err) {
-      console.error(source_default.red(`Failed to update config: ${err.message}`));
+      console.error(source_default.red(`Failed to update config for ${client.name}: ${err.message}`));
     }
   }
+  if (configuredCount === 0 && !isDryRun) {
+    console.log(source_default.yellow("\u26A0\uFE0F No supported MCP clients found to configure automatically."));
+  }
   const sourceExt = getExtensionPath();
   const targetExt = getUserExtensionDir();
   console.log(source_default.dim(`Setting up extension in ${targetExt}...`));
@@ -5617,34 +5635,47 @@ __export(status_exports, {
 });
 async function status() {
   console.log(source_default.bold("\u{1F47B} Ghost Bridge Status"));
-  const configPath = getClaudeConfigPath();
+  const clientConfigs = getClientConfigPaths();
   const extDir = getUserExtensionDir();
   const serverPath = getServerPath();
-  let mcpStatus = source_default.red("Not Configured");
-  let mcpDetails = "";
-  if (import_fs_extra3.default.existsSync(configPath)) {
-    try {
-      const config = await import_fs_extra3.default.readJson(configPath);
-      if (config.mcpServers && config.mcpServers["ghost-bridge"]) {
-        mcpStatus = source_default.green("Configured");
-        const cfg = config.mcpServers["ghost-bridge"];
-        const configuredPath = cfg.args[0];
-        if (configuredPath === serverPath) {
-          mcpDetails = source_default.dim("(Paths match)");
-        } else {
-          mcpDetails = source_default.yellow(`(Path mismatch)
-  Configured: ${configuredPath}
-  Current:    ${serverPath}`);
+  console.log(source_default.bold.blue("\nMCP Client Configurations:"));
+  let configuredCount = 0;
+  for (const client of clientConfigs) {
+    let mcpStatus = source_default.gray("Not Configured");
+    let mcpDetails = "";
+    const configPath = client.path;
+    if (import_fs_extra3.default.existsSync(configPath)) {
+      try {
+        const config = await import_fs_extra3.default.readJson(configPath);
+        if (config.mcpServers && config.mcpServers["ghost-bridge"]) {
+          mcpStatus = source_default.green("Configured");
+          const cfg = config.mcpServers["ghost-bridge"];
+          const configuredPath = cfg.args[0];
+          if (configuredPath === serverPath) {
+            mcpDetails = source_default.dim("(Paths match)");
+          } else {
+            mcpDetails = source_default.yellow(`(Path mismatch) 
+      Configured: ${configuredPath}
+      Current:    ${serverPath}`);
+          }
+          configuredCount++;
         }
+      } catch (e) {
+        mcpStatus = source_default.red("Error reading config");
+      }
+    } else {
+      if (client.name === "Claude Code") {
+        mcpStatus = source_default.yellow("Config file not found");
+      } else {
+        mcpStatus = source_default.gray("Not Installed");
       }
-    } catch (e) {
-      mcpStatus = source_default.red("Error reading config");
     }
-  } else {
-    mcpStatus = source_default.yellow("Config file not found");
+    console.log(`  ${source_default.bold(client.name)}: ${mcpStatus} ${mcpDetails}`);
+    console.log(`    Config File: ${source_default.dim(configPath)}`);
+  }
+  if (configuredCount === 0) {
+    console.log(source_default.yellow("\n  No MCP clients currently have ghost-bridge configured. Run `ghost-bridge init`."));
   }
-  console.log(`MCP Configuration: ${mcpStatus} ${mcpDetails}`);
-  console.log(`  Config File: ${configPath}`);
   let extStatus = source_default.red("Not Installed (Run init)");
   if (import_fs_extra3.default.existsSync(extDir)) {
     extStatus = source_default.green("Installed");

package/dist/server.js

@@ -28896,7 +28896,7 @@ function buildSnippet(source, line, column, { beautifyEnabled = true, contextLin
   return result;
 }
 var server = new Server(
-  { name: "ghost-bridge", version: "0.3.0" },
+  { name: "ghost-bridge", version: "0.4.0" },
   { capabilities: { tools: {} } }
 );
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -29067,6 +29067,66 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
           }
         }
       }
+    },
+    {
+      name: "get_interactive_snapshot",
+      description: "\u3010\u64CD\u4F5C\u9875\u9762\u524D\u5FC5\u987B\u5148\u8C03\u7528\u3011\u626B\u63CF\u5F53\u524D\u9875\u9762\u6240\u6709\u53EF\u89C1\u7684\u53EF\u4EA4\u4E92\u5143\u7D20\uFF08\u6309\u94AE/\u94FE\u63A5/\u8F93\u5165\u6846/\u4E0B\u62C9\u6846\u7B49\uFF09\uFF0C\u8FD4\u56DE\u5E26\u6709 ref \u77ED\u6807\u8BC6\uFF08\u5982 e1, e2, e3\uFF09\u7684\u7CBE\u7B80\u5217\u8868\uFF0C\u5305\u542B\u5143\u7D20\u7C7B\u578B\u3001\u6587\u672C\u548C\u4F4D\u7F6E\u3002Token \u6781\u7701\uFF08\u901A\u5E38 < 1000 tokens\uFF09\uFF0C\u4E13\u4E3A AI \u64CD\u4F5C\u9875\u9762\u800C\u8BBE\u8BA1\u3002\u83B7\u53D6\u540E\u53EF\u901A\u8FC7 dispatch_action \u5DE5\u5177\u4F7F\u7528 ref \u6807\u8BC6\u6765\u70B9\u51FB\u3001\u586B\u5199\u3001\u6309\u952E\u7B49\u3002\u652F\u6301 Shadow DOM \u7A7F\u900F\u3002\n\u26A0\uFE0F \u4EC5\u7528\u4E8E\u4EA4\u4E92\u64CD\u4F5C\u524D\u7684\u5143\u7D20\u5B9A\u4F4D\u3002\u5982\u9700\u6392\u67E5 UI/CSS \u5E03\u5C40\u95EE\u9898\uFF0C\u8BF7\u4F7F\u7528 capture_screenshot \u6216 get_page_content\u3002",
+      inputSchema: {
+        type: "object",
+        properties: {
+          selector: {
+            type: "string",
+            description: "CSS \u9009\u62E9\u5668\uFF0C\u9650\u5B9A\u626B\u63CF\u8303\u56F4\u3002\u4E0D\u6307\u5B9A\u5219\u626B\u63CF\u6574\u4E2A\u9875\u9762"
+          },
+          includeText: {
+            type: "boolean",
+            description: "\u662F\u5426\u5305\u542B\u5143\u7D20\u7684\u6587\u672C/\u5360\u4F4D\u7B26\u7B49\u4FE1\u606F\uFF0C\u9ED8\u8BA4 true"
+          },
+          maxElements: {
+            type: "number",
+            description: "\u6700\u5927\u8FD4\u56DE\u5143\u7D20\u6570\u91CF\uFF0C\u9ED8\u8BA4 100"
+          }
+        }
+      }
+    },
+    {
+      name: "dispatch_action",
+      description: "\u3010\u64CD\u4F5C\u9875\u9762\u5143\u7D20\u3011\u5BF9 get_interactive_snapshot \u8FD4\u56DE\u7684\u5143\u7D20\u6267\u884C\u52A8\u4F5C\u3002\u901A\u8FC7 ref \u6807\u8BC6\uFF08\u5982 e1, e5\uFF09\u7CBE\u51C6\u5B9A\u4F4D\u5143\u7D20\uFF0C\u4F7F\u7528 CDP \u7269\u7406\u7EA7\u6A21\u62DF\u6267\u884C\u64CD\u4F5C\uFF0C\u517C\u5BB9\u6240\u6709\u524D\u7AEF\u6846\u67B6\uFF08React/Vue/Angular\uFF09\uFF0C\u6210\u529F\u7387\u6781\u9AD8\u3002\n\u652F\u6301\u7684\u52A8\u4F5C\uFF1Aclick\uFF08\u70B9\u51FB\uFF09\u3001fill\uFF08\u586B\u5199\u8F93\u5165\u6846\uFF09\u3001press\uFF08\u6309\u952E\u5982 Enter\uFF09\u3001scroll\uFF08\u6EDA\u52A8\uFF09\u3001select\uFF08\u4E0B\u62C9\u9009\u62E9\uFF09\u3001hover\uFF08\u60AC\u505C\uFF09\u3001focus\uFF08\u805A\u7126\uFF09\u3002\n\u26A0\uFE0F \u4F7F\u7528\u524D\u5FC5\u987B\u5148\u8C03\u7528 get_interactive_snapshot \u83B7\u53D6\u5143\u7D20\u5217\u8868\u3002\u64CD\u4F5C\u540E\u5EFA\u8BAE\u7528 capture_screenshot \u6216\u518D\u6B21 get_interactive_snapshot \u9A8C\u8BC1\u7ED3\u679C\u3002",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ref: {
+            type: "string",
+            description: "\u76EE\u6807\u5143\u7D20\u7684 ref \u6807\u8BC6\uFF0C\u5982 'e1'\u3001'e5'\uFF08\u4ECE get_interactive_snapshot \u83B7\u53D6\uFF09"
+          },
+          action: {
+            type: "string",
+            enum: ["click", "fill", "press", "scroll", "select", "hover", "focus"],
+            description: "\u8981\u6267\u884C\u7684\u52A8\u4F5C\u7C7B\u578B"
+          },
+          value: {
+            type: "string",
+            description: "fill \u65F6\u4E3A\u8981\u8F93\u5165\u7684\u6587\u672C\uFF1Bselect \u65F6\u4E3A\u8981\u9009\u62E9\u7684 option value\uFF1Bpress \u65F6\u4E3A\u6309\u952E\u540D\uFF08\u53EF\u9009\uFF09"
+          },
+          key: {
+            type: "string",
+            description: "press \u52A8\u4F5C\u7684\u6309\u952E\u540D\uFF0C\u5982 'Enter'\u3001'Escape'\u3001'Tab'\u3001'Backspace'\u3002\u9ED8\u8BA4 'Enter'"
+          },
+          deltaX: {
+            type: "number",
+            description: "scroll \u52A8\u4F5C\u7684\u6C34\u5E73\u6EDA\u52A8\u91CF\uFF08\u50CF\u7D20\uFF09\uFF0C\u9ED8\u8BA4 0"
+          },
+          deltaY: {
+            type: "number",
+            description: "scroll \u52A8\u4F5C\u7684\u5782\u76F4\u6EDA\u52A8\u91CF\uFF08\u50CF\u7D20\uFF09\uFF0C\u9ED8\u8BA4 300\uFF08\u6B63\u6570\u5411\u4E0B\uFF0C\u8D1F\u6570\u5411\u4E0A\uFF09"
+          },
+          waitMs: {
+            type: "number",
+            description: "\u64CD\u4F5C\u540E\u7B49\u5F85\u9875\u9762\u54CD\u5E94\u7684\u65F6\u95F4\uFF08\u6BEB\u79D2\uFF09\uFF0C\u9ED8\u8BA4 500\uFF0C\u6700\u5927 3000"
+          }
+        },
+        required: ["ref", "action"]
+      }
     }
   ]
 }));
@@ -29223,6 +29283,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const res = await askChrome("getPageContent", { mode, selector, maxLength, includeMetadata });
       return { content: [{ type: "text", text: jsonText(res) }] };
     }
+    if (name === "get_interactive_snapshot") {
+      const { selector, includeText, maxElements } = args;
+      const res = await askChrome("getInteractiveSnapshot", { selector, includeText, maxElements });
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
+    if (name === "dispatch_action") {
+      const { ref, action, value, key, deltaX, deltaY, waitMs } = args;
+      const res = await askChrome("dispatchAction", { ref, action, value, key, deltaX, deltaY, waitMs }, { timeoutMs: 1e4 });
+      return { content: [{ type: "text", text: jsonText(res) }] };
+    }
     return { content: [{ type: "text", text: `\u672A\u77E5\u5DE5\u5177\uFF1A${name}` }] };
   } catch (e) {
     return { content: [{ type: "text", text: `Error: ${e.message}` }] };