mcpbrowser 0.3.56 → 0.3.58

package/README.md

@@ -498,6 +498,31 @@ Logs go to `stderr` so they don't interfere with MCP protocol on `stdout`.
 - Keep the browser tab open (default behavior)
 - Use the same domain for related requests
 
+**E401 error with `npx` / private npm registry?**
+
+If your project has a `.npmrc` that points to a private registry (e.g., Azure Artifacts, GitHub Packages, Artifactory), `npx` will try to fetch `mcpbrowser` from that registry instead of npmjs.org and fail with `E401`.
+
+**Fix:** Add `npm_config_registry` to the `env` block in your MCP config:
+```json
+{
+  "mcpServers": {
+    "mcpbrowser": {
+      "command": "npx",
+      "args": ["-y", "mcpbrowser@latest"],
+      "env": {
+        "npm_config_registry": "https://registry.npmjs.org"
+      }
+    }
+  }
+}
+```
+
+**Alternative:** Install globally to skip `npx` entirely:
+```bash
+npm install -g mcpbrowser
+```
+Then use `"command": "mcpbrowser"` with no `args` in your MCP config.
+
 ## Links
 
 - [GitHub](https://github.com/cherchyk/MCPBrowser)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpbrowser",
-  "version": "0.3.56",
+  "version": "0.3.58",
   "mcpName": "io.github.cherchyk/mcpbrowser",
   "type": "module",
   "description": "MCP browser server — loads and interacts with web pages using the user's Chromium-based browser with full JavaScript execution. Handles authentication, SSO, and anti-bot protection automatically via the user's existing browser session.",

package/src/actions/click-element.js

@@ -114,16 +114,16 @@ export const CLICK_ELEMENT_TOOL = {
         properties: {
           status: { type: "string", enum: ["success", "timeout", "error"] },
           durationMs: { type: "number" },
-          error: { type: ["string", "null"] }
+          error: { type: "string" }
         },
         required: ["status", "durationMs"]
       },
       fallbackAttempt: {
-        type: ["object", "null"],
+        type: "object",
         properties: {
           status: { type: "string", enum: ["success", "timeout", "error"] },
           durationMs: { type: "number" },
-          error: { type: ["string", "null"] }
+          error: { type: "string" }
         },
         required: ["status", "durationMs"],
         description: "Present when fallbackUsed is true"
@@ -140,7 +140,7 @@ export const CLICK_ELEMENT_TOOL = {
       currentUrl: { type: "string", description: "URL after click" },
       message: { type: "string", description: "Status message" },
       html: { 
-        type: ["string", "null"], 
+        type: "string", 
         description: "Page HTML if returnHtml was true, null otherwise" 
       },
       forms: { type: "array", items: { type: "object" }, description: "Detected forms with fields, selectors, and metadata (when returnHtml is true)" },

package/src/actions/detect-forms.js

@@ -123,7 +123,7 @@ export const DETECT_FORMS_TOOL = {
               }
             },
             submitButton: {
-              type: ["object", "null"],
+              type: "object",
               properties: {
                 selector: { type: "string" },
                 text: { type: "string" },

package/src/actions/execute-javascript.js

@@ -36,8 +36,13 @@ export class ExecuteJavascriptResponse extends MCPResponse {
   }
 
   _getAdditionalFields() {
+    // outputSchema declares result as type: 'string' (serialized).
+    // Ensure non-string values (numbers, objects, arrays) are stringified.
+    const serializedResult = this.result == null ? null
+      : typeof this.result === 'string' ? this.result
+      : JSON.stringify(this.result);
     return {
-      result: this.result,
+      result: serializedResult,
       type: this.type,
       executionTimeMs: this.executionTimeMs,
       truncated: this.truncated,
@@ -74,14 +79,14 @@ export const EXECUTE_JAVASCRIPT_TOOL = {
   outputSchema: {
     type: 'object',
     properties: {
-      result: { description: 'Serialized result of the script', nullable: true },
+      result: { type: 'string', description: 'Serialized result of the script', nullable: true },
       type: { type: 'string', description: 'Type of the returned result' },
       executionTimeMs: { type: 'number', description: 'Script execution duration' },
       truncated: { type: 'boolean', description: 'True if result was capped to size limit' },
       urlChanged: { type: 'boolean', description: 'True if page URL changed during execution' },
       currentUrl: { type: 'string', description: 'URL after execution' },
       nextSteps: { type: 'array', items: { type: 'string' } },
-      error: { type: ['object', 'null'], description: 'Error object when script throws or times out' },
+      error: { type: 'object', description: 'Error object when script throws or times out' },
       recommendedPlugins: {
         type: 'array',
         items: { type: 'object' },

package/src/actions/fetch-page.js

@@ -81,8 +81,9 @@ export const FETCH_WEBPAGE_TOOL = {
       url: { type: "string", description: "The URL to fetch" },
       browser: { 
         type: "string", 
-        description: "Browser to use: 'chrome' or 'edge'. Leave empty for auto-detection. Uses CDP to connect to the user's existing browser session.",
-        enum: ["", "chrome", "edge"]
+        enum: ["chrome", "edge", "brave"],
+        description: "Browser to use. Uses CDP to connect to the user's existing browser session.",
+        default: "chrome"
       },
       removeUnnecessaryHTML: { type: "boolean", description: "Remove Unnecessary HTML for size reduction by 90%.", default: true },
       selector: { type: "string", description: "CSS selector to extract a specific DOM subtree instead of the full page. Use to scope extraction and reduce response size (e.g., 'main', '[role=\"main\"]', 'body > div:first-child'). If no elements match, falls back to full page with a note." },

package/src/actions/navigate-history.js

@@ -94,7 +94,7 @@ export const NAVIGATE_HISTORY_TOOL = {
       direction: { type: "string", enum: ["back", "forward"], description: "Navigation direction used" },
       previousUrl: { type: "string", description: "URL before navigation" },
       currentUrl: { type: "string", description: "URL after navigation" },
-      html: { type: ["string", "null"], description: "Page HTML content after navigation (null if returnHtml=false)" },
+      html: { type: "string", description: "Page HTML content after navigation (null if returnHtml=false)" },
       nextSteps: {
         type: "array",
         items: { type: "string" },

package/src/actions/scroll-page.js

@@ -105,7 +105,8 @@ export const SCROLL_PAGE_TOOL = {
       direction: { 
         type: "string", 
         enum: ["up", "down", "left", "right"],
-        description: "Direction to scroll. Use with 'amount' parameter." 
+        description: "Direction to scroll. Use with 'amount' parameter.",
+        default: "down"
       },
       amount: { 
         type: "number", 

package/src/actions/type-text.js

@@ -100,7 +100,7 @@ export const TYPE_TEXT_TOOL = {
       currentUrl: { type: "string", description: "URL after typing" },
       message: { type: "string", description: "Success message" },
       html: { 
-        type: ["string", "null"], 
+        type: "string", 
         description: "Page HTML if returnHtml was true, null otherwise" 
       },
       nextSteps: { 

package/src/mcp-browser.js

@@ -71,6 +71,17 @@ async function main() {
     }
   );
 
+  // Capture the negotiated MCP protocol version so the ListTools handler can
+  // strip fields that older clients cannot parse (outputSchema, annotations,
+  // title were added in MCP protocol 2025-03-26).
+  let negotiatedProtocolVersion = null;
+  const _origOnInitialize = server._oninitialize.bind(server);
+  server._oninitialize = async function(request) {
+    const result = await _origOnInitialize(request);
+    negotiatedProtocolVersion = result.protocolVersion;
+    return result;
+  };
+
   // Wire server to logger so logs flow to agent via notifications/message.
   attachLoggerServer(server);
 
@@ -106,7 +117,16 @@ async function main() {
     ...pluginTools
   ];
 
-  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    // outputSchema, annotations, and title require MCP protocol 2025-03-26+.
+    // Strip them for clients that negotiated an older version (e.g. Antigravity/Gemini).
+    if (!negotiatedProtocolVersion || negotiatedProtocolVersion < '2025-03-26') {
+      return {
+        tools: tools.map(({ outputSchema, annotations, title, ...core }) => core)
+      };
+    }
+    return { tools };
+  });
 
   // --- Prompts handlers ---
   server.setRequestHandler(ListPromptsRequestSchema, async () => ({ prompts: PROMPTS }));