electron

This MCP server exposes debugging and control capabilities for Electron applications by bridging MCP with the Chrome DevTools Protocol. It lets you start and monitor Electron processes, connect to debugging targets, issue CDP commands, evaluate JavaScript in page contexts, and manage logs and targets across running Electron instances. Clients communicate over stdio using MCP messages, enabling scripted or programmatic debugging workflows against Electron apps.

To use it, clone or install the server, install dependencies, and start the server in Node.js mode. Once running, connect an MCP client to the server via standard input/output. You can list running Electron processes, start new apps with debugging enabled, retrieve detailed process information, and issue CDP commands (e.g., reload pages, pause/resume scripts, or evaluate code) against specific targets. The server also provides resource endpoints to fetch logs, targets, and process details, making it easier to orchestrate complex debugging sessions across multiple Electron instances.

Prerequisites:

• Node.js (v14+ recommended) and npm
• Git

Install steps:

1. Clone the repository git clone https://github.com/yourusername/electron-mcp-server.git

2. Navigate to the project directory cd electron-mcp-server

3. Install dependencies npm install

4. Build the project (transpile TS to JS if using TypeScript) npm run build

5. Start the MCP server npm run start

Note: The server communicates over stdio using MCP, so ensure your client is prepared to speak MCP messages over stdin/stdout.

Tips:

• Ensure Node.js version compatibility with the project’s TypeScript configuration and Electron debugging integration.
• If you modify code, re-run the build step before starting the server to generate updated JS bundles.
• The server uses stdio for MCP communication; if you need to integrate with a different transport, you may need to adapt the server or your client accordingly.
• Common issues include port conflicts or missing dependencies—check npm install logs and Electron binary paths if you customize the app startup.
• Review the available MCP operations and endpoints to understand what you can start, stop, list, reload, evaluate, pause, or resume for Electron processes.