brave-mcp 0.1.0

package/build/src/utils/keyboard.js

@@ -0,0 +1,296 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// See the KeyInput type for the list of supported keys.
+const validKeys = new Set([
+    '0',
+    '1',
+    '2',
+    '3',
+    '4',
+    '5',
+    '6',
+    '7',
+    '8',
+    '9',
+    'Power',
+    'Eject',
+    'Abort',
+    'Help',
+    'Backspace',
+    'Tab',
+    'Numpad5',
+    'NumpadEnter',
+    'Enter',
+    '\r',
+    '\n',
+    'ShiftLeft',
+    'ShiftRight',
+    'ControlLeft',
+    'ControlRight',
+    'AltLeft',
+    'AltRight',
+    'Pause',
+    'CapsLock',
+    'Escape',
+    'Convert',
+    'NonConvert',
+    'Space',
+    'Numpad9',
+    'PageUp',
+    'Numpad3',
+    'PageDown',
+    'End',
+    'Numpad1',
+    'Home',
+    'Numpad7',
+    'ArrowLeft',
+    'Numpad4',
+    'Numpad8',
+    'ArrowUp',
+    'ArrowRight',
+    'Numpad6',
+    'Numpad2',
+    'ArrowDown',
+    'Select',
+    'Open',
+    'PrintScreen',
+    'Insert',
+    'Numpad0',
+    'Delete',
+    'NumpadDecimal',
+    'Digit0',
+    'Digit1',
+    'Digit2',
+    'Digit3',
+    'Digit4',
+    'Digit5',
+    'Digit6',
+    'Digit7',
+    'Digit8',
+    'Digit9',
+    'KeyA',
+    'KeyB',
+    'KeyC',
+    'KeyD',
+    'KeyE',
+    'KeyF',
+    'KeyG',
+    'KeyH',
+    'KeyI',
+    'KeyJ',
+    'KeyK',
+    'KeyL',
+    'KeyM',
+    'KeyN',
+    'KeyO',
+    'KeyP',
+    'KeyQ',
+    'KeyR',
+    'KeyS',
+    'KeyT',
+    'KeyU',
+    'KeyV',
+    'KeyW',
+    'KeyX',
+    'KeyY',
+    'KeyZ',
+    'MetaLeft',
+    'MetaRight',
+    'ContextMenu',
+    'NumpadMultiply',
+    'NumpadAdd',
+    'NumpadSubtract',
+    'NumpadDivide',
+    'F1',
+    'F2',
+    'F3',
+    'F4',
+    'F5',
+    'F6',
+    'F7',
+    'F8',
+    'F9',
+    'F10',
+    'F11',
+    'F12',
+    'F13',
+    'F14',
+    'F15',
+    'F16',
+    'F17',
+    'F18',
+    'F19',
+    'F20',
+    'F21',
+    'F22',
+    'F23',
+    'F24',
+    'NumLock',
+    'ScrollLock',
+    'AudioVolumeMute',
+    'AudioVolumeDown',
+    'AudioVolumeUp',
+    'MediaTrackNext',
+    'MediaTrackPrevious',
+    'MediaStop',
+    'MediaPlayPause',
+    'Semicolon',
+    'Equal',
+    'NumpadEqual',
+    'Comma',
+    'Minus',
+    'Period',
+    'Slash',
+    'Backquote',
+    'BracketLeft',
+    'Backslash',
+    'BracketRight',
+    'Quote',
+    'AltGraph',
+    'Props',
+    'Cancel',
+    'Clear',
+    'Shift',
+    'Control',
+    'Alt',
+    'Accept',
+    'ModeChange',
+    ' ',
+    'Print',
+    'Execute',
+    '\u0000',
+    'a',
+    'b',
+    'c',
+    'd',
+    'e',
+    'f',
+    'g',
+    'h',
+    'i',
+    'j',
+    'k',
+    'l',
+    'm',
+    'n',
+    'o',
+    'p',
+    'q',
+    'r',
+    's',
+    't',
+    'u',
+    'v',
+    'w',
+    'x',
+    'y',
+    'z',
+    'Meta',
+    '*',
+    '+',
+    '-',
+    '/',
+    ';',
+    '=',
+    ',',
+    '.',
+    '`',
+    '[',
+    '\\',
+    ']',
+    "'",
+    'Attn',
+    'CrSel',
+    'ExSel',
+    'EraseEof',
+    'Play',
+    'ZoomOut',
+    ')',
+    '!',
+    '@',
+    '#',
+    '$',
+    '%',
+    '^',
+    '&',
+    '(',
+    'A',
+    'B',
+    'C',
+    'D',
+    'E',
+    'F',
+    'G',
+    'H',
+    'I',
+    'J',
+    'K',
+    'L',
+    'M',
+    'N',
+    'O',
+    'P',
+    'Q',
+    'R',
+    'S',
+    'T',
+    'U',
+    'V',
+    'W',
+    'X',
+    'Y',
+    'Z',
+    ':',
+    '<',
+    '_',
+    '>',
+    '?',
+    '~',
+    '{',
+    '|',
+    '}',
+    '"',
+    'SoftLeft',
+    'SoftRight',
+    'Camera',
+    'Call',
+    'EndCall',
+    'VolumeDown',
+    'VolumeUp',
+]);
+function throwIfInvalidKey(key) {
+    if (validKeys.has(key)) {
+        return key;
+    }
+    throw new Error(`${key} is invalid. Valid keys are: ${Array.from(validKeys.values()).join(',')}.`);
+}
+/**
+ * Returns the primary key, followed by modifiers in original order.
+ */
+export function parseKey(keyInput) {
+    let key = '';
+    const result = [];
+    for (const ch of keyInput) {
+        // Handle cases like Shift++.
+        if (ch === '+' && key) {
+            result.push(throwIfInvalidKey(key));
+            key = '';
+        }
+        else {
+            key += ch;
+        }
+    }
+    if (key) {
+        result.push(throwIfInvalidKey(key));
+    }
+    if (result.length === 0) {
+        throw new Error(`Key ${keyInput} could not be parsed.`);
+    }
+    if (new Set(result).size !== result.length) {
+        throw new Error(`Key ${keyInput} contains duplicate keys.`);
+    }
+    return [result.at(-1), ...result.slice(0, -1)];
+}

package/build/src/utils/pagination.js

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const DEFAULT_PAGE_SIZE = 20;
+export function paginate(items, options) {
+    const total = items.length;
+    if (!options || noPaginationOptions(options)) {
+        return {
+            items,
+            currentPage: 0,
+            totalPages: 1,
+            hasNextPage: false,
+            hasPreviousPage: false,
+            startIndex: 0,
+            endIndex: total,
+            invalidPage: false,
+        };
+    }
+    const pageSize = options.pageSize ?? DEFAULT_PAGE_SIZE;
+    const totalPages = Math.max(1, Math.ceil(total / pageSize));
+    const { currentPage, invalidPage } = resolvePageIndex(options.pageIdx, totalPages);
+    const startIndex = currentPage * pageSize;
+    const pageItems = items.slice(startIndex, startIndex + pageSize);
+    const endIndex = startIndex + pageItems.length;
+    return {
+        items: pageItems,
+        currentPage,
+        totalPages,
+        hasNextPage: currentPage < totalPages - 1,
+        hasPreviousPage: currentPage > 0,
+        startIndex,
+        endIndex,
+        invalidPage,
+    };
+}
+function noPaginationOptions(options) {
+    return options.pageSize === undefined && options.pageIdx === undefined;
+}
+function resolvePageIndex(pageIdx, totalPages) {
+    if (pageIdx === undefined) {
+        return { currentPage: 0, invalidPage: false };
+    }
+    if (pageIdx < 0 || pageIdx >= totalPages) {
+        return { currentPage: 0, invalidPage: true };
+    }
+    return { currentPage: pageIdx, invalidPage: false };
+}

package/build/src/utils/string.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Converts a given string to snake_case.
+ * This function handles camelCase, PascalCase, and acronyms, including transitions between letters and numbers.
+ * It uses Unicode-aware regular expressions (`\p{L}`, `\p{N}`, `\p{Lu}`, `\p{Ll}` with the `u` flag)
+ * to correctly process letters and numbers from various languages.
+ *
+ * @param text The input string to convert to snake_case.
+ * @returns The snake_case version of the input string.
+ */
+export function toSnakeCase(text) {
+    if (!text) {
+        return '';
+    }
+    // First, handle case-based transformations to insert underscores correctly.
+    // 1. Add underscore between a letter and a number.
+    //    e.g., "version2" -> "version_2"
+    // 2. Add underscore between an uppercase letter sequence and a following uppercase+lowercase sequence.
+    //    e.g., "APIFlags" -> "API_Flags"
+    // 3. Add underscore between a lowercase/number and an uppercase letter.
+    //    e.g., "lastName" -> "last_Name", "version_2Update" -> "version_2_Update"
+    // 4. Replace sequences of non-alphanumeric with a single underscore
+    // 5. Remove any leading or trailing underscores.
+    const result = text
+        .replace(/(\p{L})(\p{N})/gu, '$1_$2') // 1
+        .replace(/(\p{Lu}+)(\p{Lu}\p{Ll})/gu, '$1_$2') // 2
+        .replace(/(\p{Ll}|\p{N})(\p{Lu})/gu, '$1_$2') // 3
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, '_') // 4
+        .replace(/^_|_$/g, ''); // 5
+    return result;
+}

package/build/src/utils/types.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/build/src/version.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const VERSION = '0.1.0';

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "brave-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Brave DevTools",
+  "type": "module",
+  "bin": {
+    "brave-mcp": "./build/src/bin/brave-devtools-mcp.js",
+    "brave-devtools-mcp": "./build/src/bin/brave-devtools-mcp.js",
+    "brave-devtools": "./build/src/bin/brave-devtools.js"
+  },
+  "main": "./build/src/index.js",
+  "scripts": {
+    "cli:generate": "node --experimental-strip-types scripts/generate-cli.ts",
+    "clean": "node -e \"require('fs').rmSync('build', {recursive: true, force: true})\"",
+    "bundle": "npm run clean && npm run build && rollup -c rollup.config.mjs && node -e \"require('fs').rmSync('build/node_modules', {recursive: true, force: true})\" && node --experimental-strip-types scripts/append-lighthouse-notices.ts",
+    "build": "tsc && node --experimental-strip-types --no-warnings=ExperimentalWarning scripts/post-build.ts",
+    "typecheck": "tsc --noEmit",
+    "format": "eslint --cache --fix . && prettier --write --cache .",
+    "check-format": "eslint --cache . && prettier --check --cache .;",
+    "gen": "npm run build && npm run docs:generate && npm run cli:generate && npm run update-tool-call-metrics && npm run format",
+    "docs:generate": "node --experimental-strip-types scripts/generate-docs.ts",
+    "start": "npm run build && node build/src/index.js",
+    "start-debug": "DEBUG=mcp:* DEBUG_COLORS=false npm run build && node build/src/index.js",
+    "test": "npm run build && node scripts/test.mjs",
+    "test:no-build": "node scripts/test.mjs",
+    "test:only": "npm run build && node scripts/test.mjs --test-only",
+    "test:update-snapshots": "npm run build && node scripts/test.mjs --test-update-snapshots",
+    "test:brave": "npm run build && node tests/e2e/brave-integration.test.mjs",
+    "prepare": "node --experimental-strip-types scripts/prepare.ts",
+    "verify-server-json-version": "node --experimental-strip-types scripts/verify-server-json-version.ts",
+    "update-lighthouse": "node --experimental-strip-types scripts/update-lighthouse.ts",
+    "update-tool-call-metrics": "node --experimental-strip-types scripts/update_tool_call_metrics.ts",
+    "verify-npm-package": "node scripts/verify-npm-package.mjs",
+    "eval": "npm run build && node --experimental-strip-types scripts/eval_gemini.ts",
+    "count-tokens": "node --experimental-strip-types scripts/count_tokens.ts"
+  },
+  "files": [
+    "build/src",
+    "LICENSE",
+    "!*.tsbuildinfo"
+  ],
+  "repository": "nichochar/brave-devtools-mcp",
+  "author": "Emanuele Triuzzi",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/nichochar/brave-devtools-mcp/issues"
+  },
+  "homepage": "https://github.com/nichochar/brave-devtools-mcp#readme",
+  "mcpName": "io.github.nichochar/brave-devtools-mcp",
+  "devDependencies": {
+    "@eslint/js": "^9.35.0",
+    "@google/genai": "^1.37.0",
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@stylistic/eslint-plugin": "^5.4.0",
+    "@types/debug": "^4.1.12",
+    "@types/filesystem": "^0.0.36",
+    "@types/node": "^25.0.0",
+    "@types/sinon": "^21.0.0",
+    "@types/yargs": "^17.0.33",
+    "@typescript-eslint/eslint-plugin": "^8.43.0",
+    "@typescript-eslint/parser": "^8.43.0",
+    "chrome-devtools-frontend": "1.0.1611825",
+    "core-js": "3.49.0",
+    "debug": "4.4.3",
+    "eslint": "^9.35.0",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^17.0.0",
+    "lighthouse": "13.1.0",
+    "prettier": "^3.6.2",
+    "puppeteer": "24.40.0",
+    "rollup": "4.60.1",
+    "rollup-plugin-cleanup": "^3.2.1",
+    "rollup-plugin-license": "^3.6.0",
+    "sinon": "^21.0.0",
+    "tiktoken": "^1.0.22",
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.43.0",
+    "yargs": "18.0.0"
+  },
+  "engines": {
+    "node": "^20.19.0 || ^22.12.0 || >=23"
+  }
+}