@debugelectron/debug-electron-mcp 1.6.9 → 1.7.0

package/dist/project-registry.d.ts

@@ -0,0 +1,24 @@
+export interface ProjectConfig {
+    port: number;
+    windowTitlePattern?: string;
+}
+export interface RegistryConfig {
+    portRange: [number, number];
+    projects: Record<string, ProjectConfig>;
+}
+declare class ProjectRegistry {
+    private config;
+    private configPath;
+    private static instance;
+    private constructor();
+    static getInstance(): ProjectRegistry;
+    register(name: string, port?: number, windowTitlePattern?: string): ProjectConfig;
+    unregister(name: string): boolean;
+    resolve(name: string): ProjectConfig | undefined;
+    list(): Record<string, ProjectConfig>;
+    getNextFreePort(): number;
+    save(): void;
+    load(): void;
+}
+export declare const projectRegistry: ProjectRegistry;
+export {};

package/dist/schemas.d.ts

@@ -47,8 +47,11 @@ export declare const SendCommandToElectronSchema: z.ZodObject<{
     }>>;
     targetId: z.ZodOptional<z.ZodString>;
     windowTitle: z.ZodOptional<z.ZodString>;
+    projectName: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     command: string;
+    projectName?: string | undefined;
+    targetId?: string | undefined;
     windowTitle?: string | undefined;
     args?: {
         text?: string | undefined;
@@ -58,9 +61,10 @@ export declare const SendCommandToElectronSchema: z.ZodObject<{
         selector?: string | undefined;
         placeholder?: string | undefined;
     } | undefined;
-    targetId?: string | undefined;
 }, {
     command: string;
+    projectName?: string | undefined;
+    targetId?: string | undefined;
     windowTitle?: string | undefined;
     args?: {
         text?: string | undefined;
@@ -70,45 +74,80 @@ export declare const SendCommandToElectronSchema: z.ZodObject<{
         selector?: string | undefined;
         placeholder?: string | undefined;
     } | undefined;
-    targetId?: string | undefined;
 }>;
 export declare const TakeScreenshotSchema: z.ZodObject<{
     outputPath: z.ZodOptional<z.ZodString>;
+    targetId: z.ZodOptional<z.ZodString>;
     windowTitle: z.ZodOptional<z.ZodString>;
+    projectName: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    projectName?: string | undefined;
     outputPath?: string | undefined;
+    targetId?: string | undefined;
     windowTitle?: string | undefined;
 }, {
+    projectName?: string | undefined;
     outputPath?: string | undefined;
+    targetId?: string | undefined;
     windowTitle?: string | undefined;
 }>;
 export declare const ReadElectronLogsSchema: z.ZodObject<{
     logType: z.ZodOptional<z.ZodEnum<["console", "main", "renderer", "all"]>>;
     lines: z.ZodOptional<z.ZodNumber>;
     follow: z.ZodOptional<z.ZodBoolean>;
+    projectName: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    projectName?: string | undefined;
     logType?: "console" | "main" | "renderer" | "all" | undefined;
     lines?: number | undefined;
     follow?: boolean | undefined;
 }, {
+    projectName?: string | undefined;
     logType?: "console" | "main" | "renderer" | "all" | undefined;
     lines?: number | undefined;
     follow?: boolean | undefined;
 }>;
 export declare const GetElectronWindowInfoSchema: z.ZodObject<{
     includeChildren: z.ZodOptional<z.ZodBoolean>;
+    projectName: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     includeChildren?: boolean | undefined;
+    projectName?: string | undefined;
 }, {
     includeChildren?: boolean | undefined;
+    projectName?: string | undefined;
 }>;
 export declare const ListElectronWindowsSchema: z.ZodObject<{
     includeDevTools: z.ZodOptional<z.ZodBoolean>;
+    projectName: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    projectName?: string | undefined;
     includeDevTools?: boolean | undefined;
 }, {
+    projectName?: string | undefined;
     includeDevTools?: boolean | undefined;
 }>;
+export declare const RegisterProjectSchema: z.ZodObject<{
+    projectName: z.ZodString;
+    port: z.ZodOptional<z.ZodNumber>;
+    windowTitlePattern: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectName: string;
+    port?: number | undefined;
+    windowTitlePattern?: string | undefined;
+}, {
+    projectName: string;
+    port?: number | undefined;
+    windowTitlePattern?: string | undefined;
+}>;
+export declare const UnregisterProjectSchema: z.ZodObject<{
+    projectName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectName: string;
+}, {
+    projectName: string;
+}>;
+export declare const ListProjectsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 export type ToolInput = {
     type: 'object';
     properties: Record<string, any>;

package/dist/screenshot.d.ts

@@ -1,7 +1,18 @@
+/** Options for taking a screenshot */
+export interface ScreenshotOptions {
+    /** Path to save the screenshot (optional, defaults to in-memory only) */
+    outputPath?: string;
+    /** CDP target ID to screenshot a specific window (exact match, takes priority over windowTitle) */
+    targetId?: string;
+    /** Window title to screenshot (case-insensitive partial match) */
+    windowTitle?: string;
+    /** Specific ports to scan (overrides default port scanning) */
+    ports?: number[];
+}
 /**
  * Take a screenshot of the running Electron application using Chrome DevTools Protocol
  */
-export declare function takeScreenshot(outputPath?: string, windowTitle?: string): Promise<{
+export declare function takeScreenshot(options?: ScreenshotOptions): Promise<{
     filePath?: string;
     base64: string;
     data: string;

package/dist/serve.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Start the MCP server in HTTP mode using StreamableHTTPServerTransport.
+ * Uses only Node built-in http — no express or other dependencies.
+ * Supports multiple concurrent AI client sessions.
+ */
+export declare function startHttpServer(port?: number): Promise<void>;

package/dist/tools.d.ts

@@ -4,7 +4,10 @@ export declare enum ToolName {
     TAKE_SCREENSHOT = "take_screenshot",
     READ_ELECTRON_LOGS = "read_electron_logs",
     GET_ELECTRON_WINDOW_INFO = "get_electron_window_info",
-    LIST_ELECTRON_WINDOWS = "list_electron_windows"
+    LIST_ELECTRON_WINDOWS = "list_electron_windows",
+    REGISTER_PROJECT = "register_project",
+    UNREGISTER_PROJECT = "unregister_project",
+    LIST_PROJECTS = "list_projects"
 }
 export declare const tools: {
     name: ToolName;

package/dist/utils/electron-connection.d.ts

@@ -18,6 +18,8 @@ export interface WindowTargetOptions {
     targetId?: string;
     /** Window title (case-insensitive partial match) */
     windowTitle?: string;
+    /** Specific ports to scan (overrides default port scanning) */
+    ports?: number[];
 }
 /**
  * Find and connect to a running Electron application.

package/dist/utils/electron-discovery.d.ts

@@ -30,8 +30,10 @@ export interface ElectronWindowResult {
 }
 /**
  * Scan for running Electron applications with DevTools enabled
+ * @param ports - Optional list of specific ports to scan. When provided, only these ports are checked.
+ *                When omitted, scans the default hardcoded port ranges.
  */
-export declare function scanForElectronApps(): Promise<ElectronAppInfo[]>;
+export declare function scanForElectronApps(ports?: number[]): Promise<ElectronAppInfo[]>;
 /**
  * Get detailed process information for running Electron applications
  */
@@ -43,10 +45,13 @@ export declare function findMainTarget(targets: any[]): any | null;
 /**
  * List all available Electron window targets across all detected apps.
  * @param includeDevTools - Whether to include DevTools windows (default: false)
+ * @param ports - Optional list of specific ports to scan
  * @returns Array of window targets with id, title, url, port, and type
  */
-export declare function listElectronWindows(includeDevTools?: boolean): Promise<ElectronWindowTarget[]>;
+export declare function listElectronWindows(includeDevTools?: boolean, ports?: number[]): Promise<ElectronWindowTarget[]>;
 /**
  * Get window information from any running Electron app
+ * @param includeChildren - Whether to include child/DevTools windows
+ * @param ports - Optional list of specific ports to scan
  */
-export declare function getElectronWindowInfo(includeChildren?: boolean): Promise<ElectronWindowResult>;
+export declare function getElectronWindowInfo(includeChildren?: boolean, ports?: number[]): Promise<ElectronWindowResult>;

package/dist/utils/electron-enhanced-commands.d.ts

@@ -6,6 +6,12 @@ export interface CommandArgs {
     placeholder?: string;
     message?: string;
     code?: string;
+    duration?: number;
+    timeout?: number;
+    startSelector?: string;
+    endSelector?: string;
+    attribute?: string;
+    slowly?: boolean;
 }
 /**
  * Enhanced command executor with improved React support.

package/dist/utils/electron-logs.d.ts

@@ -7,5 +7,9 @@ export interface LogEntry {
 }
 /**
  * Read logs from running Electron applications
+ * @param logType - Type of logs to read
+ * @param lines - Number of recent lines to read
+ * @param follow - Whether to follow/tail the logs
+ * @param ports - Optional list of specific ports to scan
  */
-export declare function readElectronLogs(logType?: LogType, lines?: number, follow?: boolean): Promise<string>;
+export declare function readElectronLogs(logType?: LogType, lines?: number, follow?: boolean, ports?: number[]): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@debugelectron/debug-electron-mcp",
-  "version": "1.6.9",
+  "version": "1.7.0",
   "description": "MCP server for Electron application automation and management. See MCP_USAGE_GUIDE.md for proper argument structure examples.",
   "main": "dist/index.js",
   "publishConfig": {
@@ -18,6 +18,7 @@
     "dev": "tsx src/index.ts",
     "dev:watch": "tsx --watch src/index.ts",
     "start": "node dist/index.js",
+    "serve": "node dist/index.js serve",
     "watch": "webpack --config webpack.config.ts --mode development --watch",
     "watch-and-serve": "webpack --config webpack.config.ts --mode development --watch & node --watch dist/index.js",
     "prepare": "npm run build",
@@ -53,6 +54,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@types/ws": "^8.18.1",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
     "electron": "^28.0.0",
     "playwright": "^1.54.1",
     "ws": "^8.18.3",