Skip to content

Let Claude drive real Chrome via chrome-devtools-mcp #519

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
srid merged 4 commits into from
Apr 14, 2026
+23 −0
Merged

Let Claude drive real Chrome via chrome-devtools-mcp #519

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
216b159
feat(mcp): wire chrome-devtools-mcp for Claude Code via nix+just
srid Apr 14, 2026
63a28ec
chore(mcp): link to microsoft/apm#655 for future encapsulation
srid Apr 14, 2026
5a844c9
refactor(mcp): move chrome-devtools recipe into agents/ai.just
srid Apr 14, 2026
e8c4c92
fix(mcp): resolve Chrome across both Linux and macOS layouts
srid Apr 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .mcp.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"mcpServers": {
"chrome-devtools": {
"command": "nix",
"args": ["develop", "--command", "just", "ai::mcp-chrome-devtools"]
}
}
}
15 changes: 15 additions & 0 deletions agents/ai.just
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,3 +61,18 @@ apm-sync: apm-audit
agent *args: apm
just prepare
{{ env('AI_AGENT', 'claude --dangerously-skip-permissions') }} {{ args }}

# Launch chrome-devtools-mcp server over stdio — wired up via the root
# `.mcp.json`, which shells out via `nix develop --command just
# ai::mcp-chrome-devtools` (Claude Code starts outside the nix devshell).
# Chrome binary resolved from Playwright's nix-provided Chrome-for-Testing
# across platforms: `chrome-linux64/chrome` on Linux and
# `chrome-mac-*/Google Chrome for Testing.app/.../Google Chrome for Testing`
# on macOS. `find` picks either layout; a miss fails loud downstream
# (empty --executable-path → MCP server errors out visibly).
#
# TODO: fold .mcp.json's entry into `dependencies.mcp` above once
# microsoft/apm#655 (Claude Code MCP adapter) merges and lands in juspay's
# fork — `.mcp.json` then becomes a generated artifact of `just ai::apm`.
mcp-chrome-devtools:
sh -c 'chrome="$(find "$PLAYWRIGHT_BROWSERS_PATH"/chromium-* \( -name chrome -o -name "Google Chrome for Testing" \) -type f -perm -u+x 2>/dev/null | head -1)"; exec npx -y chrome-devtools-mcp@latest --headless=true --isolated=true --executable-path="$chrome"'