에이전트 강화
게시자의 자체 명령입니다. PlugMCP 엔드포인트가 아닙니다.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code에는 로컬 명령용 설치 링크가 없습니다. 아래 명령을 복사해 터미널에서 실행합니다.
claude mcp add amafjarkasi-electron-mcp-server -- npx -y electron-debug-mcp@1.10.0터미널에서 실행합니다.
{ "mcpServers": { "amafjarkasi-electron-mcp-server": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
MCP server for debugging Electron apps via Chrome DevTools Protocol. Start/attach processes, capture screenshots, read console errors & network logs, inspect DOM, evaluate JS, and automate UI — built for Cursor and other MCP clients.
Most AI coding agents struggle with desktop applications: they can edit source code, but they cannot see the resulting window, click buttons, read console errors, or diagnose silent main-process crashes.
Electron Debug MCP bridges your agent directly into your Electron runtime via the Chrome DevTools Protocol (CDP) and Node inspector, unlocking full visual, interactive, and diagnostic autonomy.
flowchart LR
A["🤖 AI Agent (Cursor / Claude)"] <-->|"stdio JSON-RPC"| B["⚡ Electron Debug MCP"]
B <-->|"CDP (WebSocket)"| C["🖼️ Renderer Windows\n(DOM · AXTree · Network · V8)"]
B <-->|"Node Inspector / V8"| D["⚙️ Main Process\n(IPC · WebContents · Windows · Fuses)"]
electron_security_audit evaluates running windows against official Electron security guidelines. Flags nodeIntegration, missing contextIsolation, disabled sandbox, unsafe CSP, missing setWindowOpenHandler, unguarded will-navigate, and executable binary fuses.
Automate logins and API forms without leaking credentials. type_text({ text: "{{secret:VAR}}" }) resolves from process.env and automatically redacts the secret from return values, console logs, network entries, and HAR exports with [REDACTED].
High-level single-turn workflows reduce round trips:
act_and_verify: Action → network idle → UI assertion → automatic failure screenshot if assertion fails.triage: Instant health overview with page state, console errors, network failures, and resolved top exception stack.network_failure_report: Aggregates failed HTTP calls with response bodies inline plus an exported HAR artifact.ipc_tap: Intercepts main-process ipcMain.handle and webContents.send calls.ipc_invoke: Call any registered main-process handle channel directly with custom arguments.ipc_schema_inference: Analyzes traffic patterns and automatically emits inferred TypeScript interfaces for your preload bridge.resolve_stack decodes inline base64 and external v3 source maps. When your bundled app throws an exception, the agent gets original .ts and .tsx file names, line numbers, and original source snippets rather than minified bundle noise.
processId: Automatically defaults to the single active app session.readOnlyHint, destructiveHint) so clients can auto-approve safe queries.electron://artifact/{id}.~/.cursor/mcp.json or .cursor/mcp.json){
"mcpServers": {
"electron-debug": {
"command": "npx",
"args": ["-y", "electron-debug-mcp@latest"]
}
}
}
claude_desktop_config.json){
"mcpServers": {
"electron-debug": {
"command": "npx",
"args": ["-y", "electron-debug-mcp@latest"]
}
}
}
[!TIP] Developing locally? Run
npm run buildand configure"command": "node"with"args": ["/path/to/electron-mcp-server/build/index.js"].
All tools accept an optional processId. When only one app is running, it automatically resolves to the active process.
Expose real-time state and exported artifacts directly via standard MCP resources:
electron://server — Server status, version, and host environment.electron://info — Active process IDs, target breakdown, and recent error counts.electron://targets — Live CDP targets across all connected processes.electron://artifacts — Index of all exported screenshots, traces, heap snapshots, and HARs.electron://artifact/{id} — Fetch an exported artifact by its ID.electron://process/{id} · electron://logs/{id} · electron://console/{id} · electron://cdp/{proc}/{target}Interactive debugging recipes ready for one-click invocation:
debug_blank_window — Systematically diagnose white/blank renderers.find_renderer_exception — Isolate unhandled exceptions, inspect audits, and resolve source stacks.ui_smoke_check — End-to-end UI verification: wait, interact, and assert.attach_and_screenshot — Discover local apps, attach, and capture visual status.vision_then_act — Visual-first agent loop: see, locate semantic target, act, and verify.ax_then_assert — Accessibility-first action loop: locate by accessible name and assert state.// Step 1: Look at the screen and check for errors
{ "name": "vision", "arguments": {} }
// Step 2: Act and verify in a single turn (captures failure screenshot if assertion fails)
{
"name": "act_and_verify",
"arguments": {
"action": { "type": "click_ax", "name": "Sign In" },
"assertion": { "textIncludes": "Welcome back" }
}
}
{
"name": "type_text",
"arguments": {
"selector": "#api-key",
"text": "{{secret:MY_APP_API_KEY}}"
}
}
[!NOTE] Resolves
process.env.MY_APP_API_KEY, inserts it via CDP, returnstyped: "[REDACTED]", and automatically sanitizes the secret from all subsequent logs, console events, and HAR files.
{ "name": "electron_security_audit", "arguments": {} }
Returns checklist score (0–100), letter grade (A–F), and actionable remediation guidance for webPreferences and Electron binary fuses.
// 1. Arm tap -> 2. Run app interactions -> 3. Infer TypeScript contracts
{ "name": "ipc_schema_inference", "arguments": {} }
Generates ready-to-use TypeScript definitions for your preload APIs directly from observed runtime communication.
run_script)Execute complex, multi-action automations server-side in a single MCP roundtrip with variable interpolation, conditional branching, retries, assertion checks, and code generation.
{
"name": "run_script",
"arguments": {
"vars": {
"targetWorkspace": "workspace-alpha",
"expectedItems": 3
},
"steps": [
{
"id": "authenticate",
"tool": "type_text",
"args": {
"selector": "input#token",
"text": "{{secret:APP_API_TOKEN}}"
},
"expect": { "status": "success" }
},
{
"id": "switch_workspace",
"tool": "click",
"args": { "selector": "button.workspace-switch" },
"retry": { "retries": 3, "delayMs": 250 }
},
{
"id": "check_banner",
"tool": "eval_js",
"args": { "expression": "Boolean(document.querySelector('.promo-modal'))" }
},
{
"id": "dismiss_banner",
"if": "{{steps.check_banner.result.value}} == true",
"tool": "click",
"args": { "selector": ".promo-modal .close-btn" }
},
{
"id": "verify_workspace_state",
"tool": "eval_js",
"args": {
"expression": "({ active: document.querySelector('#current-ws').textContent.trim(), count: document.querySelectorAll('.item').length })"
},
"expect": {
"js": "result.value.active === 'workspace-alpha' && result.value.count >= 3"
}
}
],
"exportAs": "playwright"
}
}
import { test, expect, _electron as electron } from "@playwright/test";
test("executed script workflow", async () => {
const electronApp = await electron.launch({ args: ["."] });
const window = await electronApp.firstWindow();
// Step: authenticate
await window.locator("input#token").fill(process.env.APP_API_TOKEN || "");
// Step: switch_workspace
await window.locator("button.workspace-switch").click();
// Step: dismiss_banner
await window.locator(".promo-modal .close-btn").click();
// Step: verify_workspace_state
const evalResult = await window.evaluate("({ active: document.querySelector('#current-ws').textContent.trim(), count: document.querySelectorAll('.item').length })");
expect(evalResult).toBeDefined();
await electronApp.close();
});
Inspect accessibility targets with compact refs (e1, e2) and drive interactions without fragile CSS selectors:
// 1. Take snapshot with Set-of-Marks badges in the screenshot
{ "name": "vision", "arguments": { "markElements": true } }
// 2. Click directly by ref token
{ "name": "click", "arguments": { "ref": "e3" } }
// 3. Type text into ref
{ "name": "type_text", "arguments": { "ref": "e4", "text": "Hello Desktop!" } }
Bypass OS file dialogs, external URL opens, or update checks during automated test runs:
// 1. Mock dialog.showOpenDialog to return test fixtures
{
"name": "mock_electron_api",
"arguments": {
"module": "dialog",
"method": "showOpenDialog",
"returns": { "canceled": false, "filePaths": ["/fixtures/document.pdf"] }
}
}
// 2. Mock shell.openExternal
{
"name": "mock_electron_api",
"arguments": {
"module": "shell",
"method": "openExternal",
"returns": true
}
}
// 3. Inspect tracked invocations
{ "name": "get_mock_calls", "arguments": { "module": "shell", "method": "openExternal" } }
// 4. Restore original implementation
{ "name": "restore_electron_mocks", "arguments": { "module": "shell", "method": "openExternal" } }
Automate native OS menus and global keyboard shortcuts:
// 1. Inspect the full native menu tree
{ "name": "get_application_menu", "arguments": {} }
// 2. Click menu item by path or role
{ "name": "click_menu_item", "arguments": { "path": "File > Save" } }
// 3. Dispatch an Electron accelerator directly
{ "name": "trigger_shortcut", "arguments": { "accelerator": "CommandOrControl+Shift+P" } }
{ "name": "get_process_health", "arguments": {} }
Returns real-time status ("healthy", "unresponsive", or "crashed"), tracking OOM terminations, child process failures, window hangs, and memory metrics.
Save full session state (cookies, localStorage, sessionStorage) into Playwright-compatible storage state artifacts to bypass repeated login flows across tests:
// 1. Export storage state to an artifact
{ "name": "save_storage_state", "arguments": {} }
// 2. Restore state into any new Electron session
{
"name": "load_storage_state",
"arguments": {
"state": { "cookies": [...], "origins": [...] }
}
}
repro_bundle)Package a complete, self-contained zip archive containing viewport screenshot, full MHTML DOM archive, HAR network replay, source-mapped console errors, stderr tail, health metrics, and a GitHub-ready Markdown issue report in one turn:
{
"name": "repro_bundle",
"arguments": {
"notes": "Regression on checkout flow after OAuth upgrade"
}
}
Returns artifactUri: "electron://artifact/...", destination path, and the complete markdown summary ready to paste into GitHub issues or Jira.
fill_form)Fill complete multi-input forms in a single tool call from either a key-value dictionary or structured field specs:
{
"name": "fill_form",
"arguments": {
"fields": {
"Username or Email": "[email protected]",
"Password": "{{secret:APP_PASSWORD}}",
"Environment": "Staging",
"Remember Me": true
},
"submit": true,
"expect": {
"textIncludes": "Welcome back"
}
}
}
Resolves fields via accessibility tree labels, ARIA attributes, placeholders, or refs (e1), resolves secrets securely, selects dropdown options, toggles checkboxes, clicks submit, and verifies post-submit UI assertions.
offline_resilience_check)Simulate real-world network failure conditions (offline, latency, or HTTP 500) during interaction, monitor app health and error bursts, restore network, and compute an executive Resilience Grade (A–F):
{
"name": "offline_resilience_check",
"arguments": {
"faultType": "offline",
"durationMs": 1500,
"action": { "type": "click", "selector": "#save-btn" }
}
}
responsive_theme_matrix)Audit how layouts adapt across color schemes (light, dark) and viewport sizes, catching horizontal scrollbar leaks (scrollWidth > innerWidth):
{
"name": "responsive_theme_matrix",
"arguments": {
"themes": ["light", "dark"],
"viewports": [
{ "width": 800, "height": 600, "name": "compact" },
{ "width": 1280, "height": 800, "name": "desktop" }
]
}
}
ipc_fuzz_and_verify)Harden renderer-to-main IPC communication against malicious or malformed payloads (null, prototype pollution, path traversal, oversized buffers) and verify process crash resistance:
{
"name": "ipc_fuzz_and_verify",
"arguments": {
"iterations": 6
}
}
[!TIP] Complete historical release notes, API migration notes, and dependency updates are tracked in
CHANGELOG.md.
npm test # Run build, 140 unit tests, and full 111-tool smoke suite
npm run doctor # Verify environment health and port binding
npm run sync:readme # Automatically synchronize badge counts with registered tools
ISC © Electron Debug MCP contributors
MCP server for debugging Electron apps via Chrome DevTools Protocol. Start/attach processes, capture screenshots, read console errors & network logs, inspect DOM, evaluate JS, and automate UI — built
{ "mcpServers": { "amafjarkasi-electron-mcp-server": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}개요
MCP server for debugging Electron apps via Chrome DevTools Protocol. Start/attach processes, capture screenshots, read console errors & network logs, inspect DOM, evaluate JS, and automate UI — built for Cursor and other MCP clients.
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Electron은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-10-28. MCP server for debugging Electron apps via Chrome DevTools Protocol. Start/attach processes, capture screenshots, read console errors & network logs, inspect DOM, evaluate JS, and automate UI — built for Cursor and other MCP clients.