chrome-bridge-mcp 1.30.5 → 1.30.6

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chrome-bridge-mcp",
   "mcpName": "io.github.frsorrentino/chrome-bridge",
-  "version": "1.30.5",
+  "version": "1.30.6",
   "type": "module",
   "description": "Chrome Bridge by frsorrentino: MCP server that lets Claude Code borrow a tab from your own logged-in Chrome and hand it back — logins, 2FA and CAPTCHAs stay with you (handoff). 67 tools; 2.8-4.3× cheaper and up to 9.3× fewer turns than Claude in Chrome, measured; ChromeOS included.",
   "main": "server/index.js",

package/server/protocol.js

@@ -4,6 +4,10 @@
 
 import { randomBytes } from 'node:crypto';
 
+// Pagina dell'estensione sul Chrome Web Store: la ricerca dello store la trova
+// di rado, quindi chi dice «estensione non connessa» dà il link diretto.
+export const EXTENSION_STORE_URL = 'https://chromewebstore.google.com/detail/chrome-bridge-for-claude/bioknpaeahidbelaljjohjofiloeodmb';
+
 // Tipi di messaggi WebSocket
 export const MessageType = Object.freeze({
   // Comandi (server → extension)
@@ -100,7 +104,7 @@ export const MessageType = Object.freeze({
 });
 
 // Versione
-export const VERSION               = '1.30.5';
+export const VERSION               = '1.30.6';
 
 // Configurazione
 export const DEFAULT_PORT          = 8765;

package/server/tools.js

@@ -13,7 +13,7 @@ import { parse as parseHtml } from 'node-html-parser';
 import { z } from 'zod';
 import { runAssert } from './assertions.js';
 import { ensureStubServer, addStub, clearStubs, listStubs, stubHost } from './stub-server.js';
-import { MessageType, VERSION } from './protocol.js';
+import { MessageType, VERSION, EXTENSION_STORE_URL } from './protocol.js';
 import { checkLinksBatch } from './link-checker.js';
 import { toHar } from './har.js';
 import { decodeTrackingRequests, trackingLines } from './trackers.js';
@@ -839,7 +839,7 @@ export function registerTools(server, wsManager, caps = 'all', options = {}) {
   server.tool(
     'get_status',
     'Status of the bridge itself, not of a page: call it when a tool you expect is missing or browser commands fail '
-      + '(connected=false: the extension is not reachable). Also reports mode (primary/relay), host, port, server and '
+      + '(connected=false: the extension is not reachable, extension_install gives its Chrome Web Store link). Also reports mode (primary/relay), host, port, server and '
       + 'extension versions, js_evaluation (false under --no-js), write_root, read_root, session_tab_id (the implicit tab), '
       + 'owned_tabs (created by this session), uptime_sec. caps_active and caps_available: a missing tool lives in an inactive cap. '
       + 'enable is the only change it makes: it switches caps on for this session, no restart, and lists the tools added. Optional caps: '
@@ -869,6 +869,8 @@ export function registerTools(server, wsManager, caps = 'all', options = {}) {
           type: 'text',
           text: jsonText({
             connected: wsManager.isConnected(),
+            // Senza estensione l'agente ha il link da dare all'utente.
+            ...(!wsManager.isConnected() && { extension_install: EXTENSION_STORE_URL }),
             mode: wsManager.mode,
             host: wsManager.host,
             port: wsManager.port,

package/server/ws-manager.js

@@ -14,7 +14,7 @@
  */
 
 import WebSocket, { WebSocketServer } from 'ws';
-import { DEFAULT_PORT, PING_INTERVAL_MS, IDENT_TIMEOUT_MS, PENDING_RELAY_TTL_MS, getTimeout, createCommand, MessageType, VERSION } from './protocol.js';
+import { DEFAULT_PORT, PING_INTERVAL_MS, IDENT_TIMEOUT_MS, PENDING_RELAY_TTL_MS, getTimeout, createCommand, MessageType, VERSION, EXTENSION_STORE_URL } from './protocol.js';
 
 /** Quanto tenere in vita l'attesa di risposta per un comando arrivato da un relay. */
 export function relayExpiry(msg) {
@@ -134,7 +134,7 @@ export class WSManager {
           `Chrome extension not connected (server ${this.mode} on ${this.host}:${this.port}`
           + `${this.mode === 'relay' ? ', reached through another chrome-bridge instance' : ''}`
           + `, waited ${Math.round(this.connectWaitMs / 1000)}s)`
-          + ` — ${this.notConnectedHint || 'open Chrome, check the chrome-bridge extension is enabled and its port matches'}`,
+          + ` — ${this.notConnectedHint || `open Chrome, check the chrome-bridge extension is enabled and its port matches (not installed yet: ${EXTENSION_STORE_URL})`}`,
         );
       }
       return this._send(type, params);
@@ -454,7 +454,7 @@ export class WSManager {
         ws.send(JSON.stringify({
           id: msg.id,
           type: MessageType.ERROR,
-          error: 'Chrome extension not connected',
+          error: `Chrome extension not connected — install or enable it: ${EXTENSION_STORE_URL}`,
         }));
         return;
       }