brave-mcp 0.1.2 → 0.2.0

package/build/src/tools/lighthouse.js

@@ -86,8 +86,8 @@ export const lighthouseAudit = definePageTool({
             const report = generateReport(lhr, format);
             const data = encoder.encode(report);
             if (outputDirPath) {
-                const reportPath = path.join(outputDirPath, `report.${format}`);
-                const { filename } = await context.saveFile(data, reportPath);
+                const reportPath = path.join(outputDirPath, `report`);
+                const { filename } = await context.saveFile(data, reportPath, `.${format}`);
                 reportPaths.push(filename);
             }
             else {

package/build/src/tools/memory.js

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { zod } from '../third_party/index.js';
+import { ensureExtension } from '../utils/files.js';
 import { ToolCategory } from './categories.js';
 import { definePageTool } from './ToolDefinition.js';
 export const takeMemorySnapshot = definePageTool({
@@ -21,7 +22,7 @@ export const takeMemorySnapshot = definePageTool({
     handler: async (request, response, _context) => {
         const page = request.page;
         await page.pptrPage.captureHeapSnapshot({
-            path: request.params.filePath,
+            path: ensureExtension(request.params.filePath, '.heapsnapshot'),
         });
         response.appendResponseLine(`Heap snapshot saved to ${request.params.filePath}`);
     },

package/build/src/tools/pages.js

@@ -19,6 +19,7 @@ export const listPages = defineTool(args => {
         handler: async (_request, response) => {
             response.setIncludePages(true);
             response.setListInPageTools();
+            response.setListWebMcpTools();
         },
     };
 });
@@ -43,6 +44,7 @@ export const selectPage = defineTool({
         context.selectPage(page);
         response.setIncludePages(true);
         response.setListInPageTools();
+        response.setListWebMcpTools();
         if (request.params.bringToFront) {
             await page.pptrPage.bringToFront();
         }
@@ -179,7 +181,7 @@ export const navigatePage = definePageTool({
                             response.appendResponseLine(`Successfully navigated to ${request.params.url}.`);
                         }
                         catch (error) {
-                            response.appendResponseLine(`Unable to navigate in the  selected page: ${error.message}.`);
+                            response.appendResponseLine(`Unable to navigate in the selected page: ${error.message}.`);
                         }
                         break;
                     case 'back':
@@ -227,6 +229,7 @@ export const navigatePage = definePageTool({
         }
         response.setIncludePages(true);
         response.setListInPageTools();
+        response.setListWebMcpTools();
     },
 });
 export const resizePage = definePageTool({

package/build/src/tools/performance.js

@@ -142,7 +142,7 @@ async function stopTracingAndAppendOutput(page, response, context, filePath) {
                     });
                 });
             }
-            const file = await context.saveFile(dataToWrite, filePath);
+            const file = await context.saveFile(dataToWrite, filePath, filePath.endsWith('.gz') ? '.json.gz' : '.json');
             response.appendResponseLine(`The raw trace data was saved to ${file.filename}.`);
         }
         const result = await parseRawTraceBuffer(traceEventsBuffer);

package/build/src/tools/screencast.js

@@ -7,6 +7,7 @@ import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { zod } from '../third_party/index.js';
+import { ensureExtension } from '../utils/files.js';
 import { ToolCategory } from './categories.js';
 import { definePageTool } from './ToolDefinition.js';
 async function generateTempFilePath() {
@@ -33,7 +34,7 @@ export const startScreencast = definePageTool({
             return;
         }
         const filePath = request.params.path ?? (await generateTempFilePath());
-        const resolvedPath = path.resolve(filePath);
+        const resolvedPath = ensureExtension(path.resolve(filePath), '.mp4');
         const page = request.page;
         let recorder;
         try {

package/build/src/tools/screenshot.js

@@ -67,8 +67,8 @@ export const screenshot = definePageTool({
             response.appendResponseLine("Took a screenshot of the current page's viewport.");
         }
         if (request.params.filePath) {
-            const file = await context.saveFile(screenshot, request.params.filePath);
-            response.appendResponseLine(`Saved screenshot to ${file.filename}.`);
+            const result = await context.saveFile(screenshot, request.params.filePath, `.${format}`);
+            response.appendResponseLine(`Saved screenshot to ${result.filename}.`);
         }
         else if (screenshot.length >= 2_000_000) {
             const { filepath } = await context.saveTemporaryFile(screenshot, `screenshot.${request.params.format}`);

package/build/src/tools/tools.js

@@ -18,6 +18,7 @@ import * as screenshotTools from './screenshot.js';
 import * as scriptTools from './script.js';
 import * as slimTools from './slim/tools.js';
 import * as snapshotTools from './snapshot.js';
+import * as webmcpTools from './webmcp.js';
 export const createTools = (args) => {
     const rawTools = args.slim
         ? Object.values(slimTools)
@@ -36,6 +37,7 @@ export const createTools = (args) => {
             ...Object.values(screenshotTools),
             ...Object.values(scriptTools),
             ...Object.values(snapshotTools),
+            ...Object.values(webmcpTools),
         ];
     const tools = [];
     for (const tool of rawTools) {

package/build/src/tools/webmcp.js

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { zod } from '../third_party/index.js';
+import { ToolCategory } from './categories.js';
+import { definePageTool } from './ToolDefinition.js';
+export const listWebMcpTools = definePageTool({
+    name: 'list_webmcp_tools',
+    description: `Lists all WebMCP tools the page exposes.`,
+    annotations: {
+        category: ToolCategory.DEBUGGING,
+        readOnlyHint: true,
+        conditions: ['experimentalWebmcp'],
+    },
+    schema: {},
+    handler: async (_request, response, _context) => {
+        response.setListWebMcpTools();
+    },
+});
+export const executeWebMcpTool = definePageTool({
+    name: 'execute_webmcp_tool',
+    description: `Executes a WebMCP tool exposed by the page.`,
+    annotations: {
+        category: ToolCategory.DEBUGGING,
+        readOnlyHint: false,
+        conditions: ['experimentalWebmcp'],
+    },
+    schema: {
+        toolName: zod.string().describe('The name of the WebMCP tool to execute'),
+        input: zod
+            .string()
+            .optional()
+            .describe('The JSON-stringified parameters to pass to the WebMCP tool'),
+    },
+    handler: async (request, response) => {
+        const toolName = request.params.toolName;
+        let input = {};
+        if (request.params.input) {
+            try {
+                const parsed = JSON.parse(request.params.input);
+                if (typeof parsed === 'object' && parsed !== null) {
+                    input = parsed;
+                }
+                else {
+                    throw new Error('Parsed input is not an object');
+                }
+            }
+            catch (e) {
+                const errorMessage = e instanceof Error ? e.message : String(e);
+                throw new Error(`Failed to parse input as JSON: ${errorMessage}`);
+            }
+        }
+        const tools = request.page.pptrPage.webmcp.tools();
+        const tool = tools.find(t => t.name === toolName);
+        if (!tool) {
+            throw new Error(`Tool ${toolName} not found`);
+        }
+        const { status, output, errorText } = await tool.execute(input);
+        response.appendResponseLine(JSON.stringify({ status, output, errorText }, null, 2));
+    },
+});

package/build/src/utils/files.js

@@ -17,3 +17,7 @@ export async function saveTemporaryFile(data, filename) {
         throw new Error('Could not save a file', { cause: err });
     }
 }
+export function ensureExtension(filepath, extension) {
+    const ext = path.extname(filepath);
+    return filepath.slice(0, filepath.length - ext.length) + extension;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-mcp",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "MCP server for Brave DevTools",
   "type": "module",
   "bin": {
@@ -62,7 +62,7 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1611825",
+    "chrome-devtools-frontend": "1.0.1613625",
     "core-js": "3.49.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",
@@ -71,7 +71,7 @@
     "globals": "^17.0.0",
     "lighthouse": "13.1.0",
     "prettier": "^3.6.2",
-    "puppeteer": "24.40.0",
+    "puppeteer": "24.41.0",
     "rollup": "4.60.1",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",