browser-devtools-mcp 0.0.1

package/dist/tools/tool-executor.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolExecutor = void 0;
+const logger = __importStar(require("../logger"));
+class ToolExecutor {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    async executeTool(tool, args) {
+        logger.debug(`Executing tool ${tool.name()} with input: ${logger.toJson(args)}`);
+        try {
+            const result = await tool.handle(this.context, args);
+            logger.debug(`Executed tool ${tool.name()} and got output: ${logger.toJson(result)}`);
+            return result;
+        }
+        catch (err) {
+            logger.debug(`Error occurred while executing ${tool.name()}: ${err}`);
+            throw err;
+        }
+    }
+}
+exports.ToolExecutor = ToolExecutor;
+//# sourceMappingURL=tool-executor.js.map

package/dist/tools/tool-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.js","sourceRoot":"","sources":["../../src/tools/tool-executor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,kDAAoC;AAGpC,MAAa,YAAY;IACJ,OAAO,CAAoB;IAE5C,YAAY,OAA0B;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAU,EAAE,IAAe;QACzC,MAAM,CAAC,KAAK,CACR,kBAAkB,IAAI,CAAC,IAAI,EAAE,gBAAgB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CACrE,CAAC;QACF,IAAI,CAAC;YACD,MAAM,MAAM,GAAe,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACjE,MAAM,CAAC,KAAK,CACR,iBAAiB,IAAI,CAAC,IAAI,EAAE,oBAAoB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAC1E,CAAC;YACF,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CACR,kCAAkC,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAC1D,CAAC;YACF,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;CACJ;AAxBD,oCAwBC"}

package/dist/tools/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/dist/types.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpResourceType = exports.HttpMethod = exports.ConsoleMessageLevel = exports.ConsoleMessageLevelCode = exports.ConsoleMessageLevelName = void 0;
+var ConsoleMessageLevelName;
+(function (ConsoleMessageLevelName) {
+    ConsoleMessageLevelName["ALL"] = "all";
+    ConsoleMessageLevelName["DEBUG"] = "debug";
+    ConsoleMessageLevelName["INFO"] = "info";
+    ConsoleMessageLevelName["WARNING"] = "warning";
+    ConsoleMessageLevelName["ERROR"] = "error";
+})(ConsoleMessageLevelName || (exports.ConsoleMessageLevelName = ConsoleMessageLevelName = {}));
+var ConsoleMessageLevelCode;
+(function (ConsoleMessageLevelCode) {
+    ConsoleMessageLevelCode[ConsoleMessageLevelCode["ALL"] = -1] = "ALL";
+    ConsoleMessageLevelCode[ConsoleMessageLevelCode["DEBUG"] = 0] = "DEBUG";
+    ConsoleMessageLevelCode[ConsoleMessageLevelCode["INFO"] = 1] = "INFO";
+    ConsoleMessageLevelCode[ConsoleMessageLevelCode["WARNING"] = 2] = "WARNING";
+    ConsoleMessageLevelCode[ConsoleMessageLevelCode["ERROR"] = 3] = "ERROR";
+})(ConsoleMessageLevelCode || (exports.ConsoleMessageLevelCode = ConsoleMessageLevelCode = {}));
+exports.ConsoleMessageLevel = {
+    [ConsoleMessageLevelName.ALL]: { code: ConsoleMessageLevelCode.ALL },
+    [ConsoleMessageLevelName.DEBUG]: { code: ConsoleMessageLevelCode.DEBUG },
+    [ConsoleMessageLevelName.INFO]: { code: ConsoleMessageLevelCode.INFO },
+    [ConsoleMessageLevelName.WARNING]: {
+        code: ConsoleMessageLevelCode.WARNING,
+    },
+    [ConsoleMessageLevelName.ERROR]: { code: ConsoleMessageLevelCode.ERROR },
+};
+var HttpMethod;
+(function (HttpMethod) {
+    HttpMethod["GET"] = "GET";
+    HttpMethod["POST"] = "POST";
+    HttpMethod["PUT"] = "PUT";
+    HttpMethod["PATCH"] = "PATCH";
+    HttpMethod["DELETE"] = "DELETE";
+    HttpMethod["HEAD"] = "HEAD";
+    HttpMethod["OPTIONS"] = "OPTIONS";
+})(HttpMethod || (exports.HttpMethod = HttpMethod = {}));
+var HttpResourceType;
+(function (HttpResourceType) {
+    HttpResourceType["DOCUMENT"] = "document";
+    HttpResourceType["STYLESHEET"] = "stylesheet";
+    HttpResourceType["IMAGE"] = "image";
+    HttpResourceType["MEDIA"] = "media";
+    HttpResourceType["FONT"] = "font";
+    HttpResourceType["SCRIPT"] = "script";
+    HttpResourceType["TEXTTRACK"] = "texttrack";
+    HttpResourceType["XHR"] = "xhr";
+    HttpResourceType["FETCH"] = "fetch";
+    HttpResourceType["EVENTSOURCE"] = "eventsource";
+    HttpResourceType["WEBSOCKET"] = "websocket";
+    HttpResourceType["MANIFEST"] = "manifest";
+    HttpResourceType["OTHER"] = "other";
+})(HttpResourceType || (exports.HttpResourceType = HttpResourceType = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA,IAAY,uBAMX;AAND,WAAY,uBAAuB;IAC/B,sCAAW,CAAA;IACX,0CAAe,CAAA;IACf,wCAAa,CAAA;IACb,8CAAmB,CAAA;IACnB,0CAAe,CAAA;AACnB,CAAC,EANW,uBAAuB,uCAAvB,uBAAuB,QAMlC;AAED,IAAY,uBAMX;AAND,WAAY,uBAAuB;IAC/B,oEAAQ,CAAA;IACR,uEAAS,CAAA;IACT,qEAAQ,CAAA;IACR,2EAAW,CAAA;IACX,uEAAS,CAAA;AACb,CAAC,EANW,uBAAuB,uCAAvB,uBAAuB,QAMlC;AAEY,QAAA,mBAAmB,GAG5B;IACA,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,uBAAuB,CAAC,GAAG,EAAE;IACpE,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,uBAAuB,CAAC,KAAK,EAAE;IACxE,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE;IACtE,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE;QAC/B,IAAI,EAAE,uBAAuB,CAAC,OAAO;KACxC;IACD,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,uBAAuB,CAAC,KAAK,EAAE;CAClE,CAAC;AAkBX,IAAY,UAQX;AARD,WAAY,UAAU;IAClB,yBAAW,CAAA;IACX,2BAAa,CAAA;IACb,yBAAW,CAAA;IACX,6BAAe,CAAA;IACf,+BAAiB,CAAA;IACjB,2BAAa,CAAA;IACb,iCAAmB,CAAA;AACvB,CAAC,EARW,UAAU,0BAAV,UAAU,QAQrB;AAED,IAAY,gBAcX;AAdD,WAAY,gBAAgB;IACxB,yCAAqB,CAAA;IACrB,6CAAyB,CAAA;IACzB,mCAAe,CAAA;IACf,mCAAe,CAAA;IACf,iCAAa,CAAA;IACb,qCAAiB,CAAA;IACjB,2CAAuB,CAAA;IACvB,+BAAW,CAAA;IACX,mCAAe,CAAA;IACf,+CAA2B,CAAA;IAC3B,2CAAuB,CAAA;IACvB,yCAAqB,CAAA;IACrB,mCAAe,CAAA;AACnB,CAAC,EAdW,gBAAgB,gCAAhB,gBAAgB,QAc3B"}

package/dist/utils.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = sleep;
+exports.getEnumKeyTuples = getEnumKeyTuples;
+exports.createEnumTransformer = createEnumTransformer;
+exports.formattedTimeForFilename = formattedTimeForFilename;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function getEnumKeyTuples(enumObj) {
+    const values = Object.keys(enumObj)
+        .filter((key) => isNaN(Number(key))) // numeric enum reverse-mapping guard
+        .map((key) => enumObj[key]);
+    if (values.length === 0) {
+        throw new Error('Enum has no values');
+    }
+    return values;
+}
+function createEnumTransformer(enumObj, opts) {
+    const values = Object.keys(enumObj)
+        .filter((k) => isNaN(Number(k)))
+        .map((k) => enumObj[k]);
+    const caseInsensitive = opts?.caseInsensitive ?? true;
+    const lookup = new Map(values.map((v) => [
+        caseInsensitive ? v.toLowerCase() : v,
+        v,
+    ]));
+    return (value) => {
+        const key = caseInsensitive ? value.toLowerCase() : value;
+        const found = lookup.get(key);
+        if (found === undefined) {
+            throw new Error(`Invalid enum value: "${value}"`);
+        }
+        return found;
+    };
+}
+function formattedTimeForFilename(date = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return (date.getFullYear() +
+        pad(date.getMonth() + 1) +
+        pad(date.getDate()) +
+        '-' +
+        pad(date.getHours()) +
+        pad(date.getMinutes()) +
+        pad(date.getSeconds()));
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAAA,sBAIC;AAED,4CAcC;AAED,sDA2BC;AAED,4DAaC;AAhED,SAAgB,KAAK,CAAC,EAAU;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAkD,EAAE,EAAE,CACtE,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAC1B,CAAC;AACN,CAAC;AAED,SAAgB,gBAAgB,CAC5B,OAAU;IAEV,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;SAC9B,MAAM,CAAC,CAAC,GAAW,EAAW,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,qCAAqC;SAC1F,GAAG,CAAC,CAAC,GAAW,EAAc,EAAE,CAAC,OAAO,CAAC,GAAc,CAAC,CAE5D,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,MAAgE,CAAC;AAC5E,CAAC;AAED,SAAgB,qBAAqB,CACjC,OAAU,EACV,IAAoC;IAEpC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAS,EAAW,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;SAChD,GAAG,CAAC,CAAC,CAAS,EAAc,EAAE,CAAC,OAAO,CAAC,CAAY,CAAC,CAExD,CAAC;IAEF,MAAM,eAAe,GAAY,IAAI,EAAE,eAAe,IAAI,IAAI,CAAC;IAE/D,MAAM,MAAM,GAAG,IAAI,GAAG,CAClB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAa,EAAwB,EAAE,CAAC;QAChD,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;KACJ,CAAC,CACL,CAAC;IAEF,OAAO,CAAC,KAAa,EAAc,EAAE;QACjC,MAAM,GAAG,GAAW,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAClE,MAAM,KAAK,GAA2B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,GAAG,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC,CAAC;AACN,CAAC;AAED,SAAgB,wBAAwB,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE;IACtD,MAAM,GAAG,GAA0B,CAAC,CAAS,EAAU,EAAE,CACrD,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE/B,OAAO,CACH,IAAI,CAAC,WAAW,EAAE;QAClB,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACnB,GAAG;QACH,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CACzB,CAAC;AACN,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "browser-devtools-mcp",
+  "version": "0.0.1",
+  "description": "MCP Server for Browser Dev Tools",
+  "private": false,
+  "type": "commonjs",
+  "main": "./dist/index.js",
+  "bin": {
+    "browser-devtools": "./dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/server.js"
+  },
+  "author": "Serkan Ozal <serkanozal86@gmail.com> (https://github.com/serkan-ozal)",
+  "homepage": "https://github.com/serkan-ozal/browser-devtools-mcp",
+  "repository": "serkan-ozal/browser-devtools-mcp",
+  "license": "MIT",
+  "keywords": [
+    "ai",
+    "mcp",
+    "mcp-server",
+    "browser",
+    "dev-tools",
+    "debug"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsc",
+    "start": "ts-node ./src/index.ts",
+    "start:http": "ts-node ./src/index.ts --transport=streamable-http",
+    "watch": "tsc --watch",
+    "inspector": "npm run build && chmod 755 './dist/index.js' && npx @modelcontextprotocol/inspector dist/index.js",
+    "inspector:http": "npx @modelcontextprotocol/inspector http://localhost:3000/mcp --transport http",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "lint:check": "prettier --config .prettierrc.json --check ./src/*.ts ./src/**/*.ts ./src/**/**/*.ts ./src/**/**/**/*.ts",
+    "lint:format": "prettier --config .prettierrc.json --write ./src/*.ts ./src/**/*.ts ./src/**/**/*.ts ./src/**/**/**/*.ts",
+    "release:patch": "release-it --ci -VV --git.commit --git.push --git.tag --git.tagName='v${version}' --github.release --github.releaseNotes='echo \"Release ${version}\"' --no-git.requireCleanWorkingDir --no-git.requireUpstream --npm.publish --npm.skipChecks",
+    "release:minor": "release-it minor --ci -VV --git.commit --git.push --git.tag --git.tagName='v${version}' --github.release --github.releaseNotes='echo \"Release ${version}\"' --no-git.requireCleanWorkingDir --no-git.requireUpstream --npm.publish --npm.skipChecks",
+    "release:major": "release-it major --ci -VV --git.commit --git.push --git.tag --git.tagName='v${version}' --github.release --github.releaseNotes='echo \"Release ${version}\"' --no-git.requireCleanWorkingDir --no-git.requireUpstream --npm.publish --npm.skipChecks"
+  },
+  "files": [
+    "dist/",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/node": "^18.19.87",
+    "@typescript-eslint/eslint-plugin": "^8.31.1",
+    "@typescript-eslint/parser": "^8.31.1",
+    "eslint": "^9.26.0",
+    "eslint-plugin-import": "^2.31.0",
+    "prettier": "^3.5.3",
+    "release-it": "^17.6.0",
+    "rimraf": "^6.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "@hono/mcp": "^0.1.4",
+    "@hono/node-server": "^1.19.5",
+    "@modelcontextprotocol/sdk": "^1.23.1",
+    "@playwright/browser-chromium": "^1.57.0",
+    "@playwright/browser-firefox": "^1.57.0",
+    "@playwright/browser-webkit": "^1.57.0",
+    "commander": "^14.0.1",
+    "hono": "^4.9.9",
+    "playwright": "^1.57.0"
+  }
+}