feat: give owner runs a headless chrome-devtools MCP

Adds chrome-devtools-mcp 1.11.0 to the Claude runner so the owner (or a
single-mode room) can open pages, click/fill, take screenshots and read
console/network errors. Reviewer, arbiter and read-only runtimes do not
get it. Chrome runs headless with an isolated temp profile under TMPDIR,
Google usage statistics and CrUX lookups are off.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Codex
2026-10-21 12:25:04 +09:00
parent 97cc670e34
commit e3308eb119
5 changed files with 154 additions and 6 deletions

View File

@@ -34,6 +34,7 @@
"@anthropic-ai/claude-agent-sdk": "0.3.286", "@anthropic-ai/claude-agent-sdk": "0.3.286",
"@anthropic-ai/sdk": "0.100.0", "@anthropic-ai/sdk": "0.100.0",
"@modelcontextprotocol/sdk": "1.29.0", "@modelcontextprotocol/sdk": "1.29.0",
"chrome-devtools-mcp": "1.11.0",
"cron-parser": "^5.0.0", "cron-parser": "^5.0.0",
"ejclaw-runners-shared": "workspace:*", "ejclaw-runners-shared": "workspace:*",
"zod": "^4.0.0", "zod": "^4.0.0",
@@ -305,6 +306,8 @@
"chownr": ["chownr@1.1.4", "", {}, "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg=="], "chownr": ["chownr@1.1.4", "", {}, "sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg=="],
"chrome-devtools-mcp": ["chrome-devtools-mcp@1.11.0", "", { "peerDependencies": { "@blackwell-systems/gcf": "^2.2.2", "@toon-format/toon": "^4.1.0" }, "optionalPeers": ["@blackwell-systems/gcf", "@toon-format/toon"], "bin": { "chrome-devtools": "build/src/bin/chrome-devtools.js", "chrome-devtools-mcp": "build/src/bin/chrome-devtools-mcp.js" } }, "sha512-CytJ/5tnzrS+J/74be2P5aCOsS/mmGRHys/Si+IYC4ucrbnWAmES/dYdxGJjeUCECRcoFUilZAysdjlwqUjXIA=="],
"colorette": ["colorette@2.0.20", "", {}, "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w=="], "colorette": ["colorette@2.0.20", "", {}, "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w=="],
"content-disposition": ["content-disposition@1.0.1", "", {}, "sha512-oIXISMynqSqm241k6kcQ5UwttDILMK4BiurCfGEREw6+X9jkkpEe5T9FZaApyLGGOnFuyMWZpdolTXMtvEJ08Q=="], "content-disposition": ["content-disposition@1.0.1", "", {}, "sha512-oIXISMynqSqm241k6kcQ5UwttDILMK4BiurCfGEREw6+X9jkkpEe5T9FZaApyLGGOnFuyMWZpdolTXMtvEJ08Q=="],

View File

@@ -13,6 +13,7 @@
"@anthropic-ai/claude-agent-sdk": "0.3.286", "@anthropic-ai/claude-agent-sdk": "0.3.286",
"@anthropic-ai/sdk": "0.100.0", "@anthropic-ai/sdk": "0.100.0",
"@modelcontextprotocol/sdk": "1.29.0", "@modelcontextprotocol/sdk": "1.29.0",
"chrome-devtools-mcp": "1.11.0",
"cron-parser": "^5.0.0", "cron-parser": "^5.0.0",
"ejclaw-runners-shared": "workspace:*", "ejclaw-runners-shared": "workspace:*",
"zod": "^4.0.0" "zod": "^4.0.0"

View File

@@ -1,10 +1,20 @@
import { query } from '@anthropic-ai/claude-agent-sdk'; import { query } from '@anthropic-ai/claude-agent-sdk';
import { EJCLAW_ENV, IPC_POLL_MS } from 'ejclaw-runners-shared'; import {
EJCLAW_ENV,
IPC_POLL_MS,
isArbiterRuntimeEnvEnabled,
} from 'ejclaw-runners-shared';
import { compactBoundaryFromMessage } from './compaction-boundary.js'; import { compactBoundaryFromMessage } from './compaction-boundary.js';
import { getClaudeCliPath } from './claude-cli.js'; import { getClaudeCliPath } from './claude-cli.js';
import { drainIpcInput, shouldClose } from './ipc-input.js'; import { drainIpcInput, shouldClose } from './ipc-input.js';
import { buildEjclawMcpServerConfig } from './mcp-config.js'; import {
buildChromeDevtoolsMcpServerConfig,
buildEjclawMcpServerConfig,
CHROME_DEVTOOLS_MCP_SERVER_NAME,
resolveChromeDevtoolsMcpEntry,
shouldEnableChromeDevtoolsMcp,
} from './mcp-config.js';
import { import {
MessageStream, MessageStream,
buildCompactionOutput, buildCompactionOutput,
@@ -186,6 +196,11 @@ class ClaudeQueryRunner {
) )
: undefined; : undefined;
const chromeDevtoolsMcp = this.buildChromeDevtoolsMcp(
readonlyReviewerRuntime,
readonlyProtectedPaths,
);
return { return {
pathToClaudeCodeExecutable: getClaudeCliPath(this.args.log), pathToClaudeCodeExecutable: getClaudeCliPath(this.args.log),
cwd: this.effectiveCwd, cwd: this.effectiveCwd,
@@ -195,7 +210,10 @@ class ClaudeQueryRunner {
additionalDirectories: additionalDirectories:
this.extraDirs.length > 0 ? this.extraDirs : undefined, this.extraDirs.length > 0 ? this.extraDirs : undefined,
resume: this.args.sessionId, resume: this.args.sessionId,
allowedTools: this.buildAllowedTools(readonlyReviewerRuntime), allowedTools: this.buildAllowedTools(
readonlyReviewerRuntime,
Boolean(chromeDevtoolsMcp),
),
env: this.args.sdkEnv, env: this.args.sdkEnv,
permissionMode: 'bypassPermissions' as const, permissionMode: 'bypassPermissions' as const,
allowDangerouslySkipPermissions: true, allowDangerouslySkipPermissions: true,
@@ -213,6 +231,9 @@ class ClaudeQueryRunner {
ipcDir: process.env[EJCLAW_ENV.ipcDir], ipcDir: process.env[EJCLAW_ENV.ipcDir],
hostIpcDir: process.env[EJCLAW_ENV.hostIpcDir], hostIpcDir: process.env[EJCLAW_ENV.hostIpcDir],
}), }),
...(chromeDevtoolsMcp
? { [CHROME_DEVTOOLS_MCP_SERVER_NAME]: chromeDevtoolsMcp }
: {}),
}, },
hooks: { hooks: {
PreCompact: [ PreCompact: [
@@ -242,6 +263,24 @@ class ClaudeQueryRunner {
}; };
} }
private buildChromeDevtoolsMcp(readonlyRuntime: boolean, workDirs: string[]) {
const enabled = shouldEnableChromeDevtoolsMcp(
this.args.runnerInput.roomRoleContext?.role,
readonlyRuntime || isArbiterRuntimeEnvEnabled(process.env),
);
if (!enabled) return null;
const entry = resolveChromeDevtoolsMcpEntry();
if (!entry) {
this.args.log('chrome-devtools-mcp not installed, browser MCP disabled');
return null;
}
const tmpDir = process.env.TMPDIR;
return buildChromeDevtoolsMcpServerConfig(entry, [
...workDirs,
...(tmpDir ? [tmpDir] : []),
]);
}
private logRuntimeConfig(): void { private logRuntimeConfig(): void {
const model = this.resolveModel(); const model = this.resolveModel();
const thinking = this.resolveThinking(); const thinking = this.resolveThinking();
@@ -293,7 +332,10 @@ class ClaudeQueryRunner {
); );
} }
private buildAllowedTools(readonlyRuntime: boolean): string[] { private buildAllowedTools(
readonlyRuntime: boolean,
chromeDevtools: boolean,
): string[] {
const readonlyTools = [ const readonlyTools = [
'Bash', 'Bash',
'Read', 'Read',
@@ -333,7 +375,10 @@ class ClaudeQueryRunner {
'NotebookEdit', 'NotebookEdit',
'mcp__ejclaw__*', 'mcp__ejclaw__*',
]; ];
return readonlyRuntime ? readonlyTools : writeTools; if (readonlyRuntime) return readonlyTools;
return chromeDevtools
? [...writeTools, `mcp__${CHROME_DEVTOOLS_MCP_SERVER_NAME}__*`]
: writeTools;
} }
private handleMessage(message: unknown): boolean { private handleMessage(message: unknown): boolean {

View File

@@ -1,3 +1,6 @@
import { createRequire } from 'module';
import path from 'path';
import type { McpStdioServerConfig } from '@anthropic-ai/claude-agent-sdk'; import type { McpStdioServerConfig } from '@anthropic-ai/claude-agent-sdk';
import { EJCLAW_ENV } from 'ejclaw-runners-shared'; import { EJCLAW_ENV } from 'ejclaw-runners-shared';
@@ -32,3 +35,57 @@ export function buildEjclawMcpServerConfig(
}, },
}; };
} }
export const CHROME_DEVTOOLS_MCP_SERVER_NAME = 'chrome-devtools';
/**
* Browser automation is a write-capable tool (click/fill/upload on live
* sites), so it is only given to agents that are allowed to act: the paired
* owner, or a single-mode room (no role). Reviewer/arbiter stay read-only.
*/
export function shouldEnableChromeDevtoolsMcp(
roomRole: string | undefined,
readonlyRuntime: boolean,
): boolean {
if (readonlyRuntime) return false;
return !roomRole || roomRole === 'owner';
}
export function resolveChromeDevtoolsMcpEntry(): string | null {
try {
const require = createRequire(import.meta.url);
const pkgJson = require.resolve('chrome-devtools-mcp/package.json');
return path.join(
path.dirname(pkgJson),
'build/src/bin/chrome-devtools-mcp.js',
);
} catch {
return null;
}
}
/**
* Headless Chrome with a throwaway profile (no shared cookies/logins), no
* Google usage statistics and no CrUX lookups. Chrome is launched lazily on the
* first browser tool call; the temp profile lives under TMPDIR (disk, not
* tmpfs, on this host).
*/
export function buildChromeDevtoolsMcpServerConfig(
entryPath: string,
workspaceDirs: string[],
): McpStdioServerConfig {
return {
command: 'node',
args: [
entryPath,
'--headless',
'--isolated',
'--no-usage-statistics',
'--no-performance-crux',
...workspaceDirs.map((dir) => `--workspace=${dir}`),
],
env: {
CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: '1',
},
};
}

View File

@@ -1,7 +1,13 @@
import fs from 'fs';
import { describe, expect, it } from 'vitest'; import { describe, expect, it } from 'vitest';
import { EJCLAW_ENV } from 'ejclaw-runners-shared'; import { EJCLAW_ENV } from 'ejclaw-runners-shared';
import { buildEjclawMcpServerConfig } from '../src/mcp-config.js'; import {
buildChromeDevtoolsMcpServerConfig,
buildEjclawMcpServerConfig,
resolveChromeDevtoolsMcpEntry,
shouldEnableChromeDevtoolsMcp,
} from '../src/mcp-config.js';
describe('ejclaw MCP config', () => { describe('ejclaw MCP config', () => {
it('always loads EJClaw MCP tools on turn one and preserves runtime env', () => { it('always loads EJClaw MCP tools on turn one and preserves runtime env', () => {
@@ -29,3 +35,39 @@ describe('ejclaw MCP config', () => {
}); });
}); });
}); });
describe('chrome-devtools MCP config', () => {
it('is enabled only for the owner or a single-mode room', () => {
expect(shouldEnableChromeDevtoolsMcp('owner', false)).toBe(true);
expect(shouldEnableChromeDevtoolsMcp(undefined, false)).toBe(true);
expect(shouldEnableChromeDevtoolsMcp('reviewer', false)).toBe(false);
expect(shouldEnableChromeDevtoolsMcp('arbiter', false)).toBe(false);
expect(shouldEnableChromeDevtoolsMcp('owner', true)).toBe(false);
});
it('resolves the installed server entry', () => {
const entry = resolveChromeDevtoolsMcpEntry();
expect(entry).toMatch(
/chrome-devtools-mcp\/build\/src\/bin\/chrome-devtools-mcp\.js$/,
);
expect(fs.existsSync(entry!)).toBe(true);
});
it('runs headless with an isolated profile and telemetry off', () => {
const config = buildChromeDevtoolsMcpServerConfig('/x/entry.js', [
'/work',
'/home/claude/.tmp',
]);
expect(config.command).toBe('node');
expect(config.args).toEqual([
'/x/entry.js',
'--headless',
'--isolated',
'--no-usage-statistics',
'--no-performance-crux',
'--workspace=/work',
'--workspace=/home/claude/.tmp',
]);
expect(config.env?.CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS).toBe('1');
});
});