Skip to content

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

fix(agents): use cmd /c npx on Windows for init-agents MCP config (#39221)

Ing-yeo_Developer02dbf42c9765
diff --git a/packages/playwright/src/agents/generateAgents.ts b/packages/playwright/src/agents/generateAgents.ts
index 3f496893c3..a33cef0eaf 100644
--- a/packages/playwright/src/agents/generateAgents.ts
+++ b/packages/playwright/src/agents/generateAgents.ts
@@ -45,12 +45,14 @@ export class ClaudeGenerator {
for (const agent of agents)
await writeFile(`.claude/agents/${agent.name}.md`, ClaudeGenerator.agentSpec(agent), '🤖', 'agent definition');
+ // On Windows, npx resolves to npx.cmd which cannot be executed without shell: true.
+ // See: https://code.claude.com/docs/en/mcp#dynamic-tool-updates
+ const mcpServer = process.platform === 'win32'
+ ? { command: 'cmd', args: ['/c', 'npx', 'playwright', 'run-test-mcp-server'] }
+ : { command: 'npx', args: ['playwright', 'run-test-mcp-server'] };
await writeFile('.mcp.json', JSON.stringify({
mcpServers: {
- 'playwright-test': {
- command: 'npx',
- args: ['playwright', 'run-test-mcp-server'],
- }
+ 'playwright-test': mcpServer,
}
}, null, 2), '🔧', 'mcp configuration');
diff --git a/tests/mcp/init-agents.spec.ts b/tests/mcp/init-agents.spec.ts
index 5bfdb117a7..7d58446ffd 100644
--- a/tests/mcp/init-agents.spec.ts
+++ b/tests/mcp/init-agents.spec.ts
@@ -72,3 +72,20 @@ test('create seed file with --config', async ({ }) => {
});
expect(fs.existsSync(path.join(baseDir, 'custom', 'bar', 'e2e', 'seed.spec.ts'))).toBe(true);
});
+
+test('claude generates correct mcp config', async ({ }) => {
+ const baseDir = await writeFiles({
+ 'playwright.config.ts': `module.exports = {};`,
+ });
+
+ await runInitAgents({ cwd: baseDir, args: ['--loop', 'claude'] });
+
+ const mcpJson = JSON.parse(fs.readFileSync(path.join(baseDir, '.mcp.json'), 'utf-8'));
+ if (process.platform === 'win32') {
+ expect(mcpJson.mcpServers['playwright-test'].command).toBe('cmd');
+ expect(mcpJson.mcpServers['playwright-test'].args).toEqual(['/c', 'npx', 'playwright', 'run-test-mcp-server']);
+ } else {
+ expect(mcpJson.mcpServers['playwright-test'].command).toBe('npx');
+ expect(mcpJson.mcpServers['playwright-test'].args).toEqual(['playwright', 'run-test-mcp-server']);
+ }
+});