opera-devtools-mcp 0.3.0 → 0.4.1

package/README.md

@@ -205,9 +205,12 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
   - [`get_heapsnapshot_retainers`](docs/tool-reference.md#get_heapsnapshot_retainers)
   - [`get_heapsnapshot_retaining_paths`](docs/tool-reference.md#get_heapsnapshot_retaining_paths)
   - [`get_heapsnapshot_summary`](docs/tool-reference.md#get_heapsnapshot_summary)
-- **Opera** (5 tools)
+- **Opera** (8 tools)
+  - [`opera_call_mcp_tool`](docs/tool-reference.md#opera_call_mcp_tool)
   - [`opera_chat`](docs/tool-reference.md#opera_chat)
   - [`opera_do`](docs/tool-reference.md#opera_do)
+  - [`opera_list_mcp_servers`](docs/tool-reference.md#opera_list_mcp_servers)
+  - [`opera_list_mcp_tools`](docs/tool-reference.md#opera_list_mcp_tools)
   - [`opera_list_models`](docs/tool-reference.md#opera_list_models)
   - [`opera_make`](docs/tool-reference.md#opera_make)
   - [`opera_research`](docs/tool-reference.md#opera_research)

package/build/src/bin/chrome-devtools-cli-options.js

@@ -898,6 +898,30 @@ export const commands = {
             },
         },
     },
+    opera_call_mcp_tool: {
+        description: 'Execute a tool on a specific MCP server registered in the browser. Use opera_list_mcp_servers to discover available servers and tools. Only available when connected to Opera Neon.',
+        category: 'Opera',
+        args: {
+            server: {
+                name: 'server',
+                type: 'string',
+                description: 'The MCP server name (from opera_list_mcp_servers).',
+                required: true,
+            },
+            tool: {
+                name: 'tool',
+                type: 'string',
+                description: 'The tool name to execute on the server.',
+                required: true,
+            },
+            parameters: {
+                name: 'parameters',
+                type: 'object',
+                description: 'Parameters to pass to the tool. Omit if the tool takes none.',
+                required: false,
+            },
+        },
+    },
     opera_chat: {
         description: "Send a chat prompt to Opera's built-in AI and return the response. Only available when connected to Opera Neon.",
         category: 'Opera',
@@ -928,6 +952,23 @@ export const commands = {
             },
         },
     },
+    opera_list_mcp_servers: {
+        description: 'List MCP servers registered in the browser, including their connection status. Only available when connected to Opera Neon.',
+        category: 'Opera',
+        args: {},
+    },
+    opera_list_mcp_tools: {
+        description: 'List the tools exposed by a single MCP server. Prefer opera_list_mcp_servers when discovering everything at once; use this for a targeted refresh of one server. Only available when connected to Opera Neon.',
+        category: 'Opera',
+        args: {
+            server: {
+                name: 'server',
+                type: 'string',
+                description: 'The MCP server name (from opera_list_mcp_servers).',
+                required: true,
+            },
+        },
+    },
     opera_list_models: {
         description: 'List available AI models for Opera chat. Returns model IDs, display names, and which is the default. Only available when connected to Opera Neon.',
         category: 'Opera',

package/build/src/opera/tools/opera.js

@@ -210,4 +210,114 @@ export const operaListModels = definePageTool({
         }
     },
 });
+export const operaListMcpServers = definePageTool({
+    name: 'opera_list_mcp_servers',
+    description: 'List MCP servers registered in the browser, ' +
+        'including their connection status. ' +
+        'Only available when connected to Opera Neon.',
+    blockedByDialog: false,
+    verifyFilesSchema: {},
+    annotations: {
+        category: ToolCategory.OPERA,
+        readOnlyHint: true,
+    },
+    schema: {},
+    handler: async (request, response) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const session = getCDPSession(request.page.pptrPage);
+        try {
+            const result = await dispatchAction(session, {
+                action: 'listMcpServers',
+                type: 'LIST_SERVERS',
+            });
+            response.appendResponseLine(result);
+        }
+        catch (e) {
+            response.appendResponseLine(`Opera.dispatchAction(listMcpServers) failed with error: ${e.message}`);
+        }
+    },
+});
+export const operaListMcpTools = definePageTool({
+    name: 'opera_list_mcp_tools',
+    description: 'List the tools exposed by a single MCP server. Prefer opera_list_mcp_servers ' +
+        'when discovering everything at once; use this for a targeted refresh of one server. ' +
+        'Only available when connected to Opera Neon.',
+    blockedByDialog: false,
+    verifyFilesSchema: {},
+    annotations: {
+        category: ToolCategory.OPERA,
+        readOnlyHint: true,
+    },
+    schema: {
+        server: zod
+            .string()
+            .min(1)
+            .describe('The MCP server name (from opera_list_mcp_servers).'),
+    },
+    handler: async (request, response) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const session = getCDPSession(request.page.pptrPage);
+        try {
+            const result = await dispatchAction(session, {
+                action: 'listMcpTools',
+                server: request.params.server,
+                type: 'LIST_TOOLS',
+            });
+            response.appendResponseLine(result);
+        }
+        catch (e) {
+            response.appendResponseLine(`Opera.dispatchAction(listMcpTools) failed with error: ${e.message}`);
+        }
+    },
+});
+export const operaCallMcpTool = definePageTool({
+    name: 'opera_call_mcp_tool',
+    description: 'Execute a tool on a specific MCP server registered in the browser. ' +
+        'Use opera_list_mcp_servers to discover available ' +
+        'servers and tools. ' +
+        'Only available when connected to Opera Neon.',
+    blockedByDialog: false,
+    verifyFilesSchema: {},
+    annotations: {
+        category: ToolCategory.OPERA,
+        readOnlyHint: false,
+    },
+    schema: {
+        server: zod
+            .string()
+            .min(1)
+            .describe('The MCP server name (from opera_list_mcp_servers).'),
+        tool: zod
+            .string()
+            .min(1)
+            .describe('The tool name to execute on the server.'),
+        parameters: zod
+            .record(zod.unknown())
+            .optional()
+            .describe('Parameters to pass to the tool. Omit if the tool takes none.'),
+    },
+    handler: async (request, response) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const session = getCDPSession(request.page.pptrPage);
+        try {
+            const payload = {
+                action: 'callMcpTool',
+                server: request.params.server,
+                toolName: request.params.tool,
+                type: 'EXECUTE_TOOL',
+            };
+            if (request.params.parameters !== undefined) {
+                payload['parameters'] = request.params.parameters;
+            }
+            const result = await dispatchWithStreamedResponse(session, payload, chunk => response.sendLog(chunk), request.signal);
+            response.appendResponseLine(result);
+        }
+        catch (e) {
+            if (e.name === 'AbortError') {
+                throw e;
+            }
+            response.appendResponseLine(`Opera.dispatchWithStreamedResponse(callMcpTool) failed with error: ${e.message}`);
+        }
+    },
+});
 //# sourceMappingURL=opera.js.map

package/build/src/telemetry/transformation.js

@@ -20,6 +20,7 @@ const SUPPORTED_ZOD_TYPES = [
     'ZodBoolean',
     'ZodArray',
     'ZodEnum',
+    'ZodRecord',
 ];
 function isZodType(type) {
     return SUPPORTED_ZOD_TYPES.includes(type);
@@ -69,7 +70,7 @@ export function transformArgName(zodType, name) {
     if (zodType === 'ZodString') {
         transformed = `${snakeCaseName}_length`;
     }
-    else if (zodType === 'ZodArray') {
+    else if (zodType === 'ZodArray' || zodType === 'ZodRecord') {
         transformed = `${snakeCaseName}_count`;
     }
     else {
@@ -78,7 +79,9 @@ export function transformArgName(zodType, name) {
     return stripUnderscoreBeforeNumber(transformed);
 }
 export function transformArgType(zodType) {
-    if (zodType === 'ZodString' || zodType === 'ZodArray') {
+    if (zodType === 'ZodString' ||
+        zodType === 'ZodArray' ||
+        zodType === 'ZodRecord') {
         return 'number';
     }
     switch (zodType) {
@@ -110,6 +113,9 @@ function transformValue(zodType, value) {
     else if (zodType === 'ZodArray') {
         return value.length;
     }
+    else if (zodType === 'ZodRecord') {
+        return Object.keys(value).length;
+    }
     else {
         return value;
     }
@@ -127,6 +133,9 @@ function hasEquivalentType(zodType, value) {
     else if (zodType === 'ZodBoolean') {
         return typeof value === 'boolean';
     }
+    else if (zodType === 'ZodRecord') {
+        return typeof value === 'object' && value !== null && !Array.isArray(value);
+    }
     else if (zodType === 'ZodEnum') {
         return (typeof value === 'string' ||
             typeof value === 'number' ||

package/build/src/third_party/bundled-packages.json

@@ -4,6 +4,7 @@
   "lighthouse": "13.4.1",
   "semver": "7.8.5",
   "yargs": "18.1.0",
+  "zod": "3.25.76",
   "puppeteer-core": "25.6.0",
   "https://github.com/ChromeDevTools/devtools-frontend": "eaad2491924990cb310a4c753b2851e64d515f00"
 }

package/build/src/version.js

@@ -5,8 +5,5 @@
  *
  * Modified by Opera Software AS.
  */
-// If moved update release-please config
-// x-release-please-start-version
-export const VERSION = '0.3.0';
-// x-release-please-end
+export const VERSION = '0.4.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opera-devtools-mcp",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "MCP server for Opera DevTools",
   "type": "module",
   "bin": {
@@ -84,7 +84,8 @@
     "sinon": "^22.0.0",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.43.0",
-    "yargs": "18.1.0"
+    "yargs": "18.1.0",
+    "zod": "^3.25.76"
   },
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >=23"