opera-devtools-mcp 0.4.1 → 0.5.0

package/README.md

@@ -205,15 +205,21 @@ 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** (8 tools)
+- **Opera** (14 tools)
+  - [`opera_authenticate_mcp_server`](docs/tool-reference.md#opera_authenticate_mcp_server)
   - [`opera_call_mcp_tool`](docs/tool-reference.md#opera_call_mcp_tool)
   - [`opera_chat`](docs/tool-reference.md#opera_chat)
+  - [`opera_connect_mcp_server`](docs/tool-reference.md#opera_connect_mcp_server)
+  - [`opera_disable_mcp_server`](docs/tool-reference.md#opera_disable_mcp_server)
   - [`opera_do`](docs/tool-reference.md#opera_do)
+  - [`opera_enable_mcp_server`](docs/tool-reference.md#opera_enable_mcp_server)
   - [`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_register_mcp_server`](docs/tool-reference.md#opera_register_mcp_server)
   - [`opera_research`](docs/tool-reference.md#opera_research)
+  - [`opera_unregister_mcp_server`](docs/tool-reference.md#opera_unregister_mcp_server)
 - **Extensions** (5 tools)
   - [`install_extension`](docs/tool-reference.md#install_extension)
   - [`list_extensions`](docs/tool-reference.md#list_extensions)

package/build/src/McpPage.js

@@ -553,19 +553,20 @@ export class McpPage {
         return this.#resolveElementHandle(node, uid);
     }
     async #resolveElementHandle(node, uid) {
-        const message = `Element with uid ${uid} no longer exists on the page.`;
+        let handle;
         try {
-            const handle = await node.elementHandle();
-            if (!handle) {
-                throw new Error(message);
-            }
-            return handle;
+            handle = await node.elementHandle();
         }
         catch (error) {
-            throw new Error(message, {
+            const reason = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to resolve element with uid ${uid}: ${reason}`, {
                 cause: error,
             });
         }
+        if (!handle) {
+            throw new Error(`Element with uid ${uid} no longer exists on the page.`);
+        }
+        return handle;
     }
     getAXNodeByUid(uid) {
         return this.textSnapshot?.idToNode.get(uid);

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

@@ -898,6 +898,18 @@ export const commands = {
             },
         },
     },
+    opera_authenticate_mcp_server: {
+        description: 'Complete OAuth sign-in for an MCP server that requires authentication. Opens a browser popup for the OAuth flow; requires a headed (visible) browser. Only available when connected to Opera Neon.',
+        category: 'Opera',
+        args: {
+            server: {
+                name: 'server',
+                type: 'string',
+                description: 'The MCP server name to authenticate.',
+                required: true,
+            },
+        },
+    },
     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',
@@ -940,6 +952,30 @@ export const commands = {
             },
         },
     },
+    opera_connect_mcp_server: {
+        description: 'Connect to a registered MCP server. If the server requires OAuth, the response includes requiresAuth: "needed" — follow with opera_authenticate_mcp_server. Only available when connected to Opera Neon.',
+        category: 'Opera',
+        args: {
+            server: {
+                name: 'server',
+                type: 'string',
+                description: 'The MCP server name to connect.',
+                required: true,
+            },
+        },
+    },
+    opera_disable_mcp_server: {
+        description: 'Disable an MCP server without unregistering it. Only available when connected to Opera Neon.',
+        category: 'Opera',
+        args: {
+            server: {
+                name: 'server',
+                type: 'string',
+                description: 'The MCP server name to disable.',
+                required: true,
+            },
+        },
+    },
     opera_do: {
         description: "Instruct Opera's built-in AI to perform an action on the current page and return the result. Only available when connected to Opera Neon.",
         category: 'Opera',
@@ -952,6 +988,18 @@ export const commands = {
             },
         },
     },
+    opera_enable_mcp_server: {
+        description: 'Enable a disabled MCP server. Only available when connected to Opera Neon.',
+        category: 'Opera',
+        args: {
+            server: {
+                name: 'server',
+                type: 'string',
+                description: 'The MCP server name to enable.',
+                required: true,
+            },
+        },
+    },
     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',
@@ -986,6 +1034,24 @@ export const commands = {
             },
         },
     },
+    opera_register_mcp_server: {
+        description: 'Register an MCP server in the browser. Does not connect or authenticate — follow with opera_connect_mcp_server. Only available when connected to Opera Neon.',
+        category: 'Opera',
+        args: {
+            server: {
+                name: 'server',
+                type: 'string',
+                description: 'The MCP server name to register.',
+                required: true,
+            },
+            url: {
+                name: 'url',
+                type: 'string',
+                description: 'The HTTP URL of the MCP server.',
+                required: true,
+            },
+        },
+    },
     opera_research: {
         description: "Ask Opera's built-in AI to research a topic and return a summary. Only available when connected to Opera Neon.",
         category: 'Opera',
@@ -1005,6 +1071,18 @@ export const commands = {
             },
         },
     },
+    opera_unregister_mcp_server: {
+        description: 'Remove a registered MCP server and its stored auth tokens. Only available when connected to Opera Neon.',
+        category: 'Opera',
+        args: {
+            server: {
+                name: 'server',
+                type: 'string',
+                description: 'The MCP server name to unregister.',
+                required: true,
+            },
+        },
+    },
     performance_analyze_insight: {
         description: 'Provides more detailed information on a specific Performance Insight of an insight set that was highlighted in the results of a trace recording.',
         category: 'Performance',

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

@@ -73,7 +73,7 @@ export const operaChat = definePageTool({
             .describe('Model ID to use for the chat. Omit to use the browser default. Use opera_list_models to discover available IDs.'),
     },
     handler: async (request, response) => {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        // puppeteer's _client() is internal; cast to the shape getCDPSession needs
         const session = getCDPSession(request.page.pptrPage);
         try {
             const payload = {
@@ -106,7 +106,7 @@ export const operaDo = definePageTool({
             .describe('The action to perform, described in natural language.'),
     },
     handler: async (request, response) => {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        // puppeteer's _client() is internal; cast to the shape getCDPSession needs
         const session = getCDPSession(request.page.pptrPage);
         try {
             const result = await dispatchWithStreamedResponse(session, {
@@ -136,7 +136,7 @@ export const operaMake = definePageTool({
         prompt: zod.string().describe('Description of what to create or generate.'),
     },
     handler: async (request, response) => {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        // puppeteer's _client() is internal; cast to the shape getCDPSession needs
         const session = getCDPSession(request.page.pptrPage);
         try {
             const result = await dispatchAction(session, {
@@ -167,7 +167,7 @@ export const operaResearch = definePageTool({
             .describe('Depth of research. "local" uses only on-page context, "one-minute" performs a quick web search, "deep" performs a thorough multi-source search.'),
     },
     handler: async (request, response) => {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        // puppeteer's _client() is internal; cast to the shape getCDPSession needs
         const session = getCDPSession(request.page.pptrPage);
         const payload = {
             action: 'research',
@@ -199,7 +199,7 @@ export const operaListModels = definePageTool({
     },
     schema: {},
     handler: async (request, response) => {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        // puppeteer's _client() is internal; cast to the shape getCDPSession needs
         const session = getCDPSession(request.page.pptrPage);
         try {
             const result = await dispatchAction(session, { action: 'listModels' });
@@ -223,7 +223,7 @@ export const operaListMcpServers = definePageTool({
     },
     schema: {},
     handler: async (request, response) => {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        // puppeteer's _client() is internal; cast to the shape getCDPSession needs
         const session = getCDPSession(request.page.pptrPage);
         try {
             const result = await dispatchAction(session, {
@@ -255,7 +255,7 @@ export const operaListMcpTools = definePageTool({
             .describe('The MCP server name (from opera_list_mcp_servers).'),
     },
     handler: async (request, response) => {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        // puppeteer's _client() is internal; cast to the shape getCDPSession needs
         const session = getCDPSession(request.page.pptrPage);
         try {
             const result = await dispatchAction(session, {
@@ -297,7 +297,7 @@ export const operaCallMcpTool = definePageTool({
             .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
+        // puppeteer's _client() is internal; cast to the shape getCDPSession needs
         const session = getCDPSession(request.page.pptrPage);
         try {
             const payload = {
@@ -320,4 +320,182 @@ export const operaCallMcpTool = definePageTool({
         }
     },
 });
+export const operaRegisterMcpServer = definePageTool({
+    name: 'opera_register_mcp_server',
+    description: 'Register an MCP server in the browser. Does not connect or authenticate — ' +
+        'follow with opera_connect_mcp_server. 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 to register.'),
+        url: zod.string().min(1).describe('The HTTP URL of the MCP server.'),
+    },
+    handler: async (request, response) => {
+        // puppeteer's _client() is internal; cast to the shape getCDPSession needs
+        const session = getCDPSession(request.page.pptrPage);
+        try {
+            const result = await dispatchAction(session, {
+                action: 'registerMcpServer',
+                type: 'REGISTER_SERVER',
+                server: request.params.server,
+                transportInfo: { type: 'http', url: request.params.url },
+            });
+            response.appendResponseLine(result);
+        }
+        catch (e) {
+            response.appendResponseLine(`Opera.dispatchAction(registerMcpServer) failed with error: ${e.message}`);
+        }
+    },
+});
+export const operaConnectMcpServer = definePageTool({
+    name: 'opera_connect_mcp_server',
+    description: 'Connect to a registered MCP server. If the server requires OAuth, ' +
+        'the response includes requiresAuth: "needed" — follow with ' +
+        'opera_authenticate_mcp_server. 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 to connect.'),
+    },
+    handler: async (request, response) => {
+        const session = getCDPSession(request.page.pptrPage);
+        try {
+            const result = await dispatchAction(session, {
+                action: 'connectMcpServer',
+                type: 'CONNECT_SERVER',
+                server: request.params.server,
+            });
+            response.appendResponseLine(result);
+        }
+        catch (e) {
+            response.appendResponseLine(`Opera.dispatchAction(connectMcpServer) failed with error: ${e.message}`);
+        }
+    },
+});
+export const operaAuthenticateMcpServer = definePageTool({
+    name: 'opera_authenticate_mcp_server',
+    description: 'Complete OAuth sign-in for an MCP server that requires authentication. ' +
+        'Opens a browser popup for the OAuth flow; requires a headed (visible) browser. ' +
+        '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 to authenticate.'),
+    },
+    handler: async (request, response) => {
+        const session = getCDPSession(request.page.pptrPage);
+        try {
+            const result = await dispatchWithStreamedResponse(session, {
+                action: 'authenticateMcpServer',
+                type: 'AUTHENTICATE_SERVER',
+                server: request.params.server,
+            }, chunk => response.sendLog(chunk), request.signal);
+            response.appendResponseLine(result);
+        }
+        catch (e) {
+            if (e.name === 'AbortError') {
+                throw e;
+            }
+            response.appendResponseLine(`Opera.dispatchWithStreamedResponse(authenticateMcpServer) failed with error: ${e.message}`);
+        }
+    },
+});
+export const operaUnregisterMcpServer = definePageTool({
+    name: 'opera_unregister_mcp_server',
+    description: 'Remove a registered MCP server and its stored auth tokens. ' +
+        '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 to unregister.'),
+    },
+    handler: async (request, response) => {
+        const session = getCDPSession(request.page.pptrPage);
+        try {
+            const result = await dispatchAction(session, {
+                action: 'unregisterMcpServer',
+                type: 'UNREGISTER_SERVER',
+                server: request.params.server,
+            });
+            response.appendResponseLine(result);
+        }
+        catch (e) {
+            response.appendResponseLine(`Opera.dispatchAction(unregisterMcpServer) failed with error: ${e.message}`);
+        }
+    },
+});
+export const operaEnableMcpServer = definePageTool({
+    name: 'opera_enable_mcp_server',
+    description: 'Enable a disabled MCP server. 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 to enable.'),
+    },
+    handler: async (request, response) => {
+        const session = getCDPSession(request.page.pptrPage);
+        try {
+            const result = await dispatchAction(session, {
+                action: 'enableMcpServer',
+                type: 'ENABLE_SERVER',
+                server: request.params.server,
+            });
+            response.appendResponseLine(result);
+        }
+        catch (e) {
+            response.appendResponseLine(`Opera.dispatchAction(enableMcpServer) failed with error: ${e.message}`);
+        }
+    },
+});
+export const operaDisableMcpServer = definePageTool({
+    name: 'opera_disable_mcp_server',
+    description: 'Disable an MCP server without unregistering it. ' +
+        '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 to disable.'),
+    },
+    handler: async (request, response) => {
+        const session = getCDPSession(request.page.pptrPage);
+        try {
+            const result = await dispatchAction(session, {
+                action: 'disableMcpServer',
+                type: 'DISABLE_SERVER',
+                server: request.params.server,
+            });
+            response.appendResponseLine(result);
+        }
+        catch (e) {
+            response.appendResponseLine(`Opera.dispatchAction(disableMcpServer) failed with error: ${e.message}`);
+        }
+    },
+});
 //# sourceMappingURL=opera.js.map

package/build/src/version.js

@@ -5,5 +5,5 @@
  *
  * Modified by Opera Software AS.
  */
-export const VERSION = '0.4.0';
+export const VERSION = '0.5.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opera-devtools-mcp",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "MCP server for Opera DevTools",
   "type": "module",
   "bin": {
@@ -29,7 +29,6 @@
     "prepare": "node scripts/prepare.ts && node scripts/setup-intake.ts",
     "sync": "npm ci && git submodule update --init",
     "verify-upstream-seam": "node scripts/verify-upstream-seam.ts",
-    "verify-server-json-version": "node scripts/verify-server-json-version.ts",
     "update-lighthouse": "node scripts/update-lighthouse.ts",
     "update-metrics": "node scripts/update_metrics.ts",
     "verify-npm-package": "node scripts/verify-npm-package.js",