Chrome DevTools for coding agents
chore: add a script to generate CLI (#1077)
Alex Rudenkoa4533326a412
diff --git a/package.json b/package.jsonindex d9bc4392..29da4f1f 100644--- a/package.json+++ b/package.json@@ -6,6 +6,7 @@"bin": "./build/src/index.js","main": "./build/src/server.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",diff --git a/scripts/generate-cli.ts b/scripts/generate-cli.tsnew file mode 100644index 00000000..297a473e--- /dev/null+++ b/scripts/generate-cli.ts@@ -0,0 +1,175 @@+/**+ * @license+ * Copyright 2026 Google LLC+ * SPDX-License-Identifier: Apache-2.0+ */++import fs from 'node:fs';+import path from 'node:path';++import {Client} from '@modelcontextprotocol/sdk/client/index.js';+import {StdioClientTransport} from '@modelcontextprotocol/sdk/client/stdio.js';++import {parseArguments} from '../build/src/cli.js';+import {labels} from '../build/src/tools/categories.js';+import {createTools} from '../build/src/tools/tools.js';++const OUTPUT_PATH = path.join(+ import.meta.dirname,+ '../src/bin/cliDefinitions.ts',+);++async function fetchTools() {+ console.log('Connecting to chrome-devtools-mcp to fetch tools...');+ // Use the local build of the server+ const serverPath = path.join(import.meta.dirname, '../build/src/index.js');++ const transport = new StdioClientTransport({+ command: 'node',+ args: [serverPath],+ env: {...process.env, CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: 'true'},+ });++ const client = new Client(+ {+ name: 'chrome-devtools-cli-generator',+ version: '0.1.0',+ },+ {+ capabilities: {},+ },+ );++ await client.connect(transport);+ try {+ const toolsResponse = await client.listTools();+ if (!toolsResponse.tools?.length) {+ throw new Error(`No tools were fetched`);+ }+ const tools = toolsResponse.tools || [];+ console.log(`Fetched ${tools.length} tools`);+ return tools;+ } finally {+ await client.close();+ }+}++interface CliOption {+ name: string;+ type: string;+ description: string;+ required: boolean;+ default?: unknown;+ enum?: unknown[];+}++interface JsonSchema {+ type?: string | string[];+ description?: string;+ properties?: Record<string, JsonSchema>;+ required?: string[];+ default?: unknown;+ enum?: unknown[];+}++function schemaToCLIOptions(schema: JsonSchema): CliOption[] {+ if (!schema || !schema.properties) {+ return [];+ }+ const required = schema.required || [];+ const properties = schema.properties;+ return Object.entries(properties).map(([name, prop]) => {+ const isRequired = required.includes(name);+ const description = prop.description || '';+ if (typeof prop.type !== 'string') {+ throw new Error(+ `Property ${name} has a complex type not supported by CLI.`,+ );+ }+ return {+ name,+ type: prop.type,+ description,+ required: isRequired,+ default: prop.default,+ enum: prop.enum,+ };+ });+}++async function generateCli() {+ const tools = await fetchTools();+ // Sort tools by name+ const sortedTools = tools.sort((a, b) => a.name.localeCompare(b.name));++ const staticTools = createTools(parseArguments());+ const toolNameToCategory = new Map<string, string>();+ for (const tool of staticTools) {+ toolNameToCategory.set(+ tool.name,+ labels[tool.annotations.category as keyof typeof labels],+ );+ }++ const commands: Record<+ string,+ {description: string; category: string; args: Record<string, CliOption>}+ > = {};++ for (const tool of sortedTools) {+ const options = schemaToCLIOptions(tool.inputSchema);+ const args: Record<string, CliOption> = {};+ for (const opt of options) {+ args[opt.name] = opt;+ }+ const category = toolNameToCategory.get(tool.name);+ if (!category) {+ throw new Error(`Tool ${tool.name} has no category.`);+ }+ if (!tool.description) {+ throw new Error(`Tool ${tool.name} is missing descripttion`);+ }+ commands[tool.name] = {+ description: tool.description,+ category,+ args,+ };+ }++ const lines: string[] = [];+ lines.push(`/**+ * @license+ * Copyright ${new Date().getFullYear()} Google LLC+ * SPDX-License-Identifier: Apache-2.0+ */++// NOTE: do not edit manually. Auto-generated by 'npm run cli:generate'.++export interface ArgDef {+ name: string;+ type: string;+ description: string;+ required: boolean;+ default?: string | number | boolean;+ enum?: ReadonlyArray<string | number>;+}+export type Commands = Record<+ string,+ {+ description: string;+ category: string;+ args: Record<string, ArgDef>+ }+>;+export const commands: Commands = ${JSON.stringify(commands, null, 2)} as const;+`);++ fs.mkdirSync(path.dirname(OUTPUT_PATH), {recursive: true});+ fs.writeFileSync(OUTPUT_PATH, lines.join(''));+ console.log(`Generated CLI at ${OUTPUT_PATH}`);+}++generateCli().catch(err => {+ console.error('Error during generation:', err);+ process.exit(1);+});