@democratize-quality/mcp-server/src/tools/browser/dom.js

MCP Server for democratizing quality through browser automation and comprehensive API testing capabilities

const ToolBase = require('../base/ToolBase');
const browserService = require('../../services/browserService');

/**
 * Browser DOM Tool
 * Interacts with the DOM of the current browser page.
 */
class BrowserDOMTool extends ToolBase {
    static definition = {
        name: "browser_dom",
        description: "Interacts with the DOM of the current browser page.",
        input_schema: {
            type: "object",
            properties: {
                browserId: {
                    type: "string",
                    description: "The ID of the browser instance."
                },
                action: {
                    type: "string",
                    description: "The DOM action to perform (e.g., 'click', 'type')."
                },
                selector: {
                    type: "string",
                    description: "The CSS selector of the element to interact with."
                },
                text: {
                    type: "string",
                    description: "The text to type into the element (if applicable)."
                }
            },
            required: ["browserId", "action", "selector"]
        },
        output_schema: {
            type: "object",
            properties: {
                success: { type: "boolean", description: "Indicates if the DOM action was successful." },
                browserId: { type: "string", description: "The browser instance ID that was used." }
            },
            required: ["success", "browserId"]
        }
    };

    async execute(parameters) {
        const { browserId, action, selector, text } = parameters;

        console.error(`[BrowserDOMTool] Performing ${action} in browser ${browserId} on element: ${selector}`);

        try {
            switch (action) {
                case 'click':
                    await browserService.clickElement(browserId, selector);
                    break;
                case 'type':
                    await browserService.typeText(browserId, selector, text);
                    break;
                default:
                    throw new Error(`Unknown action: ${action}`);
            }

            console.error(`[BrowserDOMTool] Successfully performed ${action} in browser: ${browserId}`);
            return { success: true, browserId: browserId };
        } catch (error) {
            console.error(`[BrowserDOMTool] Failed to perform ${action}:`, error.message);
            throw new Error(`Failed to perform ${action} in browser ${browserId}: ${error.message}`);
        }
    }
}

module.exports = BrowserDOMTool;