@dr-debug/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Saswat Mohanty (https://github.com/SazWhatician)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# 🔌 @dr-debug/mcp
+
+> **Model Context Protocol (MCP) Server & Docker Telemetry Bridge for Dr. Debug**  
+> Connects running browser tabs, frontend substrate errors, and backend Docker container logs directly to AI IDEs (Cursor, Claude Code, Antigravity, Windsurf, and VS Code).
+
+[![npm version](https://img.shields.io/npm/v/@dr-debug/mcp.svg?color=blue)](https://www.npmjs.com/package/@dr-debug/mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green.svg)](https://nodejs.org/)
+
+Created by **Saswat Mohanty** ([@SazWhatician](https://github.com/SazWhatician))  
+- **GitHub:** [https://github.com/SazWhatician/DebugCopilot](https://github.com/SazWhatician/DebugCopilot)
+- **LinkedIn:** [https://www.linkedin.com/in/saswat-mohanty-0a4549331/](https://www.linkedin.com/in/saswat-mohanty-0a4549331/)
+
+---
+
+## ⚡ Instant Run (Zero Installation)
+
+Run directly with `npx`:
+
+```bash
+npx -y @dr-debug/mcp
+```
+
+This boots the dual-mode bridge:
+1. **MCP STDIO Server**: Ready for Cursor, Claude Code, Antigravity, or VS Code.
+2. **Local HTTP/WebSocket Gateway** (`http://127.0.0.1:9999`): Streams real-time Docker container states and browser telemetry.
+
+---
+
+## 🛠️ Adding to Your AI Editor / IDE
+
+### 1. Claude Desktop / Claude Code (`claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "dr-debug": {
+      "command": "npx",
+      "args": ["-y", "@dr-debug/mcp"]
+    }
+  }
+}
+```
+
+### 2. Cursor IDE (`.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "dr-debug": {
+      "command": "npx",
+      "args": ["-y", "@dr-debug/mcp"]
+    }
+  }
+}
+```
+
+---
+
+## 🔬 MCP Tools Exposed
+
+When connected, your AI coding agent has direct access to the following tools:
+
+- `list_browser_tabs`: Discover active tabs with Dr. Debug instrumented.
+- `get_browser_state`: Fetch the full `<debug_state>` snapshot (DOM anomalies, console errors, network failures).
+- `get_recent_errors`: Query high-priority substrate and runtime exceptions.
+- `get_network_log`: Inspect recent HTTP requests, status codes, and request/response payloads.
+- `list_docker_containers`: Inspect local Docker containers, images, ports, and health statuses.
+- `get_docker_logs`: Stream container standard output and standard error logs to correlate with browser errors.
+
+---
+
+## 📄 License
+
+MIT © [Saswat Mohanty](https://github.com/SazWhatician)

package/dist/DockerBridge.d.ts

@@ -0,0 +1,36 @@
+import { EventEmitter } from 'node:events';
+import type { DockerContainerInfo, DockerLogEntry, LogLevel } from './types.js';
+export interface DockerBridgeStatus {
+    isAvailable: boolean;
+    daemonRunning: boolean;
+    containerCount: number;
+    activeStreams: number;
+    error?: string;
+}
+export declare class DockerBridge extends EventEmitter {
+    private isAvailable;
+    private daemonRunning;
+    private containers;
+    private activeStreams;
+    private pollInterval?;
+    private logsBuffer;
+    private maxLogsBuffer;
+    private lastCheckError?;
+    constructor();
+    start(): Promise<void>;
+    checkDockerAvailability(): Promise<DockerBridgeStatus>;
+    refreshContainers(): Promise<DockerContainerInfo[]>;
+    private attachLogStream;
+    classifyLogLevel(msg: string, stream: 'stdout' | 'stderr'): LogLevel;
+    private startContainerPolling;
+    getContainers(): DockerContainerInfo[];
+    getLogs(options?: {
+        container?: string;
+        level?: LogLevel | 'all';
+        grep?: string;
+        tail?: number;
+    }): DockerLogEntry[];
+    getStatus(): DockerBridgeStatus;
+    stop(): void;
+}
+//# sourceMappingURL=DockerBridge.d.ts.map

package/dist/DockerBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DockerBridge.d.ts","sourceRoot":"","sources":["../src/DockerBridge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE/E,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,OAAO,CAAA;IACpB,aAAa,EAAE,OAAO,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAQ;;IAMlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB,uBAAuB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA2CtD,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAoEhE,OAAO,CAAC,eAAe;IAkEhB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ;IAwB3E,OAAO,CAAC,qBAAqB;IAOtB,aAAa,IAAI,mBAAmB,EAAE;IAItC,OAAO,CAAC,OAAO,CAAC,EAAE;QACvB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,KAAK,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;QACxB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,GAAG,cAAc,EAAE;IAwBb,SAAS,IAAI,kBAAkB;IAU/B,IAAI,IAAI,IAAI;CAiBpB"}

package/dist/DockerBridge.js

@@ -0,0 +1,266 @@
+import { spawn } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+export class DockerBridge extends EventEmitter {
+    isAvailable = false;
+    daemonRunning = false;
+    containers = new Map();
+    activeStreams = new Map();
+    pollInterval;
+    logsBuffer = [];
+    maxLogsBuffer = 500;
+    lastCheckError;
+    constructor() {
+        super();
+    }
+    async start() {
+        await this.checkDockerAvailability();
+        if (this.daemonRunning) {
+            await this.refreshContainers();
+            this.startContainerPolling(5000);
+        }
+        else {
+            // Recheck availability periodically in case Docker Desktop is booted up
+            this.pollInterval = setInterval(async () => {
+                await this.checkDockerAvailability();
+                if (this.daemonRunning) {
+                    if (this.pollInterval)
+                        clearInterval(this.pollInterval);
+                    await this.refreshContainers();
+                    this.startContainerPolling(5000);
+                }
+            }, 8000);
+        }
+    }
+    async checkDockerAvailability() {
+        return new Promise((resolve) => {
+            try {
+                const proc = spawn('docker', ['version', '--format', '{{.Server.Version}}']);
+                let stdout = '';
+                let stderr = '';
+                proc.stdout?.on('data', (d) => {
+                    stdout += d.toString();
+                });
+                proc.stderr?.on('data', (d) => {
+                    stderr += d.toString();
+                });
+                proc.on('error', (err) => {
+                    this.isAvailable = false;
+                    this.daemonRunning = false;
+                    this.lastCheckError = `Docker CLI not found or failed: ${err.message}`;
+                    resolve(this.getStatus());
+                });
+                proc.on('close', (code) => {
+                    if (code === 0 && stdout.trim().length > 0) {
+                        this.isAvailable = true;
+                        this.daemonRunning = true;
+                        this.lastCheckError = undefined;
+                    }
+                    else {
+                        this.isAvailable = true; // CLI exists
+                        this.daemonRunning = false; // Daemon is stopped
+                        this.lastCheckError = stderr.trim() || 'Docker daemon is not running';
+                    }
+                    resolve(this.getStatus());
+                });
+            }
+            catch (err) {
+                this.isAvailable = false;
+                this.daemonRunning = false;
+                this.lastCheckError = err.message;
+                resolve(this.getStatus());
+            }
+        });
+    }
+    async refreshContainers() {
+        if (!this.daemonRunning)
+            return [];
+        return new Promise((resolve) => {
+            try {
+                const proc = spawn('docker', ['ps', '--format', '{{json .}}']);
+                let output = '';
+                proc.stdout?.on('data', (d) => {
+                    output += d.toString();
+                });
+                proc.on('close', (code) => {
+                    if (code === 0) {
+                        const lines = output.split('\n').filter((l) => l.trim().length > 0);
+                        const currentNames = new Set();
+                        for (const line of lines) {
+                            try {
+                                const parsed = JSON.parse(line);
+                                const name = parsed.Names || parsed.ID || 'unknown';
+                                currentNames.add(name);
+                                const info = {
+                                    id: parsed.ID,
+                                    name,
+                                    image: parsed.Image,
+                                    status: parsed.Status,
+                                    state: (parsed.State || 'running').toLowerCase(),
+                                    ports: parsed.Ports ? parsed.Ports.split(',').map((p) => p.trim()) : []
+                                };
+                                this.containers.set(name, info);
+                                // Start streaming logs for this container if not already streaming
+                                if (!this.activeStreams.has(name)) {
+                                    this.attachLogStream(name);
+                                }
+                            }
+                            catch {
+                                // Ignore parse errors on individual lines
+                            }
+                        }
+                        // Cleanup streams for removed containers
+                        for (const [name, stream] of this.activeStreams.entries()) {
+                            if (!currentNames.has(name)) {
+                                stream.kill();
+                                this.activeStreams.delete(name);
+                                this.containers.delete(name);
+                            }
+                        }
+                        this.emit('containers', this.getContainers());
+                        resolve(this.getContainers());
+                    }
+                    else {
+                        resolve(this.getContainers());
+                    }
+                });
+                proc.on('error', () => {
+                    resolve(this.getContainers());
+                });
+            }
+            catch {
+                resolve(this.getContainers());
+            }
+        });
+    }
+    attachLogStream(containerName) {
+        if (this.activeStreams.has(containerName))
+            return;
+        try {
+            // Follow logs with 50 lines of initial history and timestamps
+            const proc = spawn('docker', ['logs', '--follow', '--tail', '50', '--timestamps', containerName]);
+            this.activeStreams.set(containerName, proc);
+            const handleLogLine = (line, stream) => {
+                if (!line.trim())
+                    return;
+                let timestamp = Date.now();
+                let message = line.trim();
+                // Extract ISO timestamp if present
+                const isoMatch = message.match(/^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z)\s+(.*)$/);
+                if (isoMatch) {
+                    const parsed = Date.parse(isoMatch[1]);
+                    if (!isNaN(parsed)) {
+                        timestamp = parsed;
+                        message = isoMatch[2];
+                    }
+                }
+                const level = this.classifyLogLevel(message, stream);
+                const entry = {
+                    id: `docker_${containerName}_${timestamp}_${Math.random().toString(36).slice(2, 7)}`,
+                    containerName,
+                    timestamp,
+                    stream,
+                    message,
+                    level
+                };
+                if (this.logsBuffer.length >= this.maxLogsBuffer) {
+                    this.logsBuffer.shift();
+                }
+                this.logsBuffer.push(entry);
+                this.emit('log', entry);
+            };
+            proc.stdout?.on('data', (d) => {
+                const lines = d.toString().split('\n');
+                lines.forEach((l) => handleLogLine(l, 'stdout'));
+            });
+            proc.stderr?.on('data', (d) => {
+                const lines = d.toString().split('\n');
+                lines.forEach((l) => handleLogLine(l, 'stderr'));
+            });
+            proc.on('close', () => {
+                this.activeStreams.delete(containerName);
+            });
+            proc.on('error', () => {
+                this.activeStreams.delete(containerName);
+            });
+        }
+        catch {
+            // Ignore spawn errors
+        }
+    }
+    classifyLogLevel(msg, stream) {
+        const upper = msg.toUpperCase();
+        if (stream === 'stderr' ||
+            upper.includes('FATAL') ||
+            upper.includes('PANIC') ||
+            upper.includes('ERROR') ||
+            upper.includes('EXCEPTION') ||
+            upper.includes('FAIL') ||
+            upper.includes('ERR_') ||
+            upper.includes('TRACEBACK') ||
+            upper.includes('CRITICAL')) {
+            return 'error';
+        }
+        if (upper.includes('WARN')) {
+            return 'warn';
+        }
+        if (upper.includes('DEBUG')) {
+            return 'log';
+        }
+        return 'info';
+    }
+    startContainerPolling(intervalMs = 5000) {
+        if (this.pollInterval)
+            clearInterval(this.pollInterval);
+        this.pollInterval = setInterval(() => {
+            this.refreshContainers();
+        }, intervalMs);
+    }
+    getContainers() {
+        return Array.from(this.containers.values());
+    }
+    getLogs(options) {
+        let result = [...this.logsBuffer];
+        if (options?.container && options.container !== 'all') {
+            const target = options.container.toLowerCase();
+            result = result.filter((l) => l.containerName.toLowerCase().includes(target));
+        }
+        if (options?.level && options.level !== 'all') {
+            result = result.filter((l) => l.level === options.level);
+        }
+        if (options?.grep) {
+            const q = options.grep.toLowerCase();
+            result = result.filter((l) => l.message.toLowerCase().includes(q));
+        }
+        if (options?.tail && options.tail > 0) {
+            result = result.slice(-options.tail);
+        }
+        return result;
+    }
+    getStatus() {
+        return {
+            isAvailable: this.isAvailable,
+            daemonRunning: this.daemonRunning,
+            containerCount: this.containers.size,
+            activeStreams: this.activeStreams.size,
+            error: this.lastCheckError
+        };
+    }
+    stop() {
+        if (this.pollInterval) {
+            clearInterval(this.pollInterval);
+            this.pollInterval = undefined;
+        }
+        for (const [name, stream] of this.activeStreams.entries()) {
+            try {
+                stream.kill();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.activeStreams.clear();
+        this.containers.clear();
+        this.logsBuffer = [];
+    }
+}
+//# sourceMappingURL=DockerBridge.js.map

package/dist/DockerBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DockerBridge.js","sourceRoot":"","sources":["../src/DockerBridge.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { DrDebugMCPServer } from './server.js';
+const port = parseInt(process.env.DR_DEBUG_MCP_PORT || '9229', 10);
+const server = new DrDebugMCPServer({ port });
+console.log(`
+┌─────────────────────────────────────────────────────────────┐
+│ 🩺 Dr. Debug Host Docker Bridge & MCP Daemon                │
+│ 👨‍💻 Created by Saswat Mohanty (@SazWhatician)               │
+│ 🔗 GitHub: https://github.com/SazWhatician                   │
+│ 💼 LinkedIn: https://www.linkedin.com/in/saswat-mohanty/    │
+└─────────────────────────────────────────────────────────────┘
+`);
+server
+    .start()
+    .then(() => {
+    console.log(`✅ Dr. Debug Daemon is active on port ${port}`);
+    console.log(`🐳 Host Docker Stream: http://localhost:${port}/docker/stream (SSE)`);
+    console.log(`🔌 Model Context Protocol: ws://localhost:${port}`);
+    console.log(`\n💡 Open your web app and click the "🐳 Docker" tab in Dr. Debug to view live container logs!`);
+})
+    .catch((err) => {
+    console.error('❌ Failed to start Dr. Debug Daemon:', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAA;AAClE,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;AAE7C,OAAO,CAAC,GAAG,CAAC;;;;;;;CAOX,CAAC,CAAA;AAEF,MAAM;KACH,KAAK,EAAE;KACP,IAAI,CAAC,GAAG,EAAE;IACT,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAA;IAC3D,OAAO,CAAC,GAAG,CAAC,2CAA2C,IAAI,sBAAsB,CAAC,CAAA;IAClF,OAAO,CAAC,GAAG,CAAC,6CAA6C,IAAI,EAAE,CAAC,CAAA;IAChE,OAAO,CAAC,GAAG,CAAC,gGAAgG,CAAC,CAAA;AAC/G,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACb,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DockerBridge, type DockerBridgeStatus } from './DockerBridge.js';
+export { MCPResourceManager } from './resources.js';
+export { DrDebugMCPServer, type DrDebugMCPServerOptions } from './server.js';
+export { MCPToolManager } from './tools.js';
+export { MCPTransport } from './transport.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { DockerBridge } from './DockerBridge.js';
+export { MCPResourceManager } from './resources.js';
+export { DrDebugMCPServer } from './server.js';
+export { MCPToolManager } from './tools.js';
+export { MCPTransport } from './transport.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA2B,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAgC,MAAM,aAAa,CAAA;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,cAAc,YAAY,CAAA"}

package/dist/resources.d.ts

@@ -0,0 +1,6 @@
+import type { BrowserTabTelemetry, MCPResource, MCPResourceContent } from './types.js';
+export declare class MCPResourceManager {
+    static listResources(sessions: Map<string, BrowserTabTelemetry>): MCPResource[];
+    static readResource(uri: string, sessions: Map<string, BrowserTabTelemetry>): MCPResourceContent;
+}
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEtF,qBAAa,kBAAkB;WACf,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,WAAW,EAAE;WA+CxE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,kBAAkB;CAqDxG"}

package/dist/resources.js

@@ -0,0 +1,94 @@
+export class MCPResourceManager {
+    static listResources(sessions) {
+        const resources = [
+            {
+                uri: 'drdebug://state/live',
+                name: 'Live Debug State Snapshot',
+                mimeType: 'application/xml',
+                description: 'Real-time <debug_state> XML token snapshot across console, network, docker, memory, and causal graphs.'
+            },
+            {
+                uri: 'drdebug://console/errors',
+                name: 'Console Runtime Error Stream',
+                mimeType: 'application/json',
+                description: 'Active uncaught runtime errors, unhandled rejections, and demangled stack frames.'
+            },
+            {
+                uri: 'drdebug://network/failures',
+                name: 'Network HTTP Failures & 4xx/5xx',
+                mimeType: 'application/json',
+                description: 'Failed HTTP requests, status codes, request/response headers, and payloads.'
+            },
+            {
+                uri: 'drdebug://interactions/replay',
+                name: 'User Interaction Replay Sequence',
+                mimeType: 'text/plain',
+                description: 'Chronological list of user clicks, inputs, scrolls, and DOM mutations in the 30 seconds leading up to bugs.'
+            },
+            {
+                uri: 'drdebug://matrix/diagnostics',
+                name: '2D Substrate Diagnostics Matrix',
+                mimeType: 'application/json',
+                description: '2D grid aggregating error severity across Network, Console, Docker, and System substrates.'
+            }
+        ];
+        // Multi-tab dynamic resources
+        for (const [tabId, tab] of sessions.entries()) {
+            resources.push({
+                uri: `drdebug://tab/${tabId}/state`,
+                name: `Live State for [${tab.title || tab.url}]`,
+                mimeType: 'application/json',
+                description: `Browser tab ${tabId}: ${tab.url}`
+            });
+        }
+        return resources;
+    }
+    static readResource(uri, sessions) {
+        const defaultSession = Array.from(sessions.values())[0];
+        const state = defaultSession?.stateSnapshot || {};
+        if (uri === 'drdebug://state/live') {
+            return {
+                uri,
+                mimeType: 'application/xml',
+                text: state.serializedXml || '<debug_state><note>No active browser session connected.</note></debug_state>'
+            };
+        }
+        if (uri === 'drdebug://console/errors') {
+            const errors = (state.console?.entries || []).filter((e) => e.level === 'error');
+            return {
+                uri,
+                mimeType: 'application/json',
+                text: JSON.stringify(errors, null, 2)
+            };
+        }
+        if (uri === 'drdebug://network/failures') {
+            const failed = (state.network?.records || []).filter((r) => r.isFailed || (r.status && r.status >= 400));
+            return {
+                uri,
+                mimeType: 'application/json',
+                text: JSON.stringify(failed, null, 2)
+            };
+        }
+        if (uri === 'drdebug://interactions/replay') {
+            const replay = state.interactionsHuman || 'No interactions recorded.';
+            return {
+                uri,
+                mimeType: 'text/plain',
+                text: replay
+            };
+        }
+        if (uri === 'drdebug://matrix/diagnostics') {
+            return {
+                uri,
+                mimeType: 'application/json',
+                text: JSON.stringify(state.diagnosticMatrix || {}, null, 2)
+            };
+        }
+        return {
+            uri,
+            mimeType: 'text/plain',
+            text: `Resource "${uri}" not found.`
+        };
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,17 @@
+import { DockerBridge } from './DockerBridge.js';
+import type { MCPRequest, MCPResponse } from './types.js';
+export interface DrDebugMCPServerOptions {
+    port?: number;
+    enableDocker?: boolean;
+}
+export declare class DrDebugMCPServer {
+    private transport;
+    private dockerBridge;
+    private isRunning;
+    constructor(options?: DrDebugMCPServerOptions);
+    getDockerBridge(): DockerBridge;
+    start(): Promise<void>;
+    handleRequest(req: MCPRequest): Promise<MCPResponse>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIhD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,SAAS,CAAQ;gBAEb,OAAO,GAAE,uBAA4B;IAK1C,eAAe,IAAI,YAAY;IAIzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAoEpD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAKnC"}

package/dist/server.js

@@ -0,0 +1,91 @@
+import { DockerBridge } from './DockerBridge.js';
+import { MCPResourceManager } from './resources.js';
+import { MCPToolManager } from './tools.js';
+import { MCPTransport } from './transport.js';
+export class DrDebugMCPServer {
+    transport;
+    dockerBridge;
+    isRunning = false;
+    constructor(options = {}) {
+        this.dockerBridge = new DockerBridge();
+        this.transport = new MCPTransport(options.port || 9229, this.dockerBridge);
+    }
+    getDockerBridge() {
+        return this.dockerBridge;
+    }
+    async start() {
+        if (this.isRunning)
+            return;
+        // Start Docker bridge discovery in background
+        this.dockerBridge.start().catch((err) => {
+            console.warn('Docker bridge initialization warning:', err.message);
+        });
+        await this.transport.start(async (req) => {
+            return this.handleRequest(req);
+        });
+        this.isRunning = true;
+    }
+    async handleRequest(req) {
+        const { id, method, params } = req;
+        const sessions = this.transport.getSessions();
+        try {
+            // 1. Initialize Handshake
+            if (method === 'initialize') {
+                return {
+                    jsonrpc: '2.0',
+                    id,
+                    result: {
+                        protocolVersion: '2024-11-05',
+                        capabilities: {
+                            resources: { subscribe: true },
+                            tools: {}
+                        },
+                        serverInfo: {
+                            name: 'Dr. Debug Autonomous Observability MCP Server',
+                            version: '0.1.0'
+                        }
+                    }
+                };
+            }
+            // 2. Resource listing
+            if (method === 'resources/list') {
+                const resources = MCPResourceManager.listResources(sessions);
+                return { jsonrpc: '2.0', id, result: { resources } };
+            }
+            // 3. Resource reading
+            if (method === 'resources/read') {
+                const content = MCPResourceManager.readResource(params.uri, sessions);
+                return { jsonrpc: '2.0', id, result: { contents: [content] } };
+            }
+            // 4. Tool listing
+            if (method === 'tools/list') {
+                const tools = MCPToolManager.listTools();
+                return { jsonrpc: '2.0', id, result: { tools } };
+            }
+            // 5. Tool execution
+            if (method === 'tools/call') {
+                const result = await MCPToolManager.callTool(params.name, params.arguments || {}, sessions, (cmd) => this.transport.sendCommandToBrowser(cmd));
+                return { jsonrpc: '2.0', id, result };
+            }
+            // Fallback for unrecognized methods
+            return {
+                jsonrpc: '2.0',
+                id,
+                error: { code: -32601, message: `Method not found: ${method}` }
+            };
+        }
+        catch (err) {
+            return {
+                jsonrpc: '2.0',
+                id,
+                error: { code: -32603, message: err.message || 'Internal MCP Server Error' }
+            };
+        }
+    }
+    async stop() {
+        this.dockerBridge.stop();
+        await this.transport.stop();
+        this.isRunning = false;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,12 @@
+import type { BrowserTabTelemetry, MCPToolDefinition } from './types.js';
+export declare class MCPToolManager {
+    static listTools(): MCPToolDefinition[];
+    static callTool(name: string, args: any, sessions: Map<string, BrowserTabTelemetry>, sendCommand: (command: any) => Promise<any>): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError?: boolean;
+    }>;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAExE,qBAAa,cAAc;WACX,SAAS,IAAI,iBAAiB,EAAE;WAoE1B,QAAQ,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC1C,WAAW,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAC1C,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAmDlF"}

package/dist/tools.js

@@ -0,0 +1,116 @@
+export class MCPToolManager {
+    static listTools() {
+        return [
+            {
+                name: 'drdebug_get_diagnostics',
+                description: 'Returns the aggregated multi-substrate health status and active anomalies in the live browser application.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tabId: {
+                            type: 'string',
+                            description: 'Optional browser tab ID (defaults to active tab).'
+                        }
+                    }
+                }
+            },
+            {
+                name: 'drdebug_inspect_request',
+                description: 'Fetches full HTTP request/response payloads, headers, timings, and curl reproduction command for an API call.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        requestId: {
+                            type: 'string',
+                            description: 'The unique request ID to inspect.'
+                        }
+                    },
+                    required: ['requestId']
+                }
+            },
+            {
+                name: 'drdebug_inspect_error',
+                description: 'Inspects a recorded runtime exception or console error, returning demangled stack frames and file locations.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        errorId: {
+                            type: 'string',
+                            description: 'The unique error ID to inspect.'
+                        }
+                    },
+                    required: ['errorId']
+                }
+            },
+            {
+                name: 'drdebug_get_interaction_replay',
+                description: 'Returns the chronological sequence of user clicks, inputs, scrolls, and navigations in the 30 seconds before errors.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {}
+                }
+            },
+            {
+                name: 'drdebug_execute_script',
+                description: 'Evaluates a JavaScript expression in the live browser tab and returns the serialized result.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        expression: {
+                            type: 'string',
+                            description: 'JavaScript code expression to evaluate.'
+                        }
+                    },
+                    required: ['expression']
+                }
+            }
+        ];
+    }
+    static async callTool(name, args, sessions, sendCommand) {
+        const defaultSession = Array.from(sessions.values())[0];
+        const state = defaultSession?.stateSnapshot || {};
+        if (name === 'drdebug_get_diagnostics') {
+            const summary = {
+                url: state.pageContext?.url || 'No active page connected',
+                title: state.pageContext?.title,
+                errorCount: (state.console?.entries || []).filter((e) => e.level === 'error').length,
+                failedRequests: (state.network?.records || []).filter((r) => r.isFailed).length,
+                memoryUsageMB: state.memory ? Math.round((state.memory.usedJSHeapSize || 0) / (1024 * 1024)) : undefined,
+                activeCorrelations: state.correlations?.length || 0,
+                matrix: state.diagnosticMatrix
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }] };
+        }
+        if (name === 'drdebug_inspect_request') {
+            const records = state.network?.records || [];
+            const req = records.find((r) => r.id === args.requestId || r.url.includes(args.requestId));
+            if (!req) {
+                return { content: [{ type: 'text', text: `Request "${args.requestId}" not found in recorded telemetry.` }], isError: true };
+            }
+            return { content: [{ type: 'text', text: JSON.stringify(req, null, 2) }] };
+        }
+        if (name === 'drdebug_inspect_error') {
+            const entries = state.console?.entries || [];
+            const err = entries.find((e) => e.id === args.errorId || e.message.includes(args.errorId));
+            if (!err) {
+                return { content: [{ type: 'text', text: `Error "${args.errorId}" not found in recorded telemetry.` }], isError: true };
+            }
+            return { content: [{ type: 'text', text: JSON.stringify(err, null, 2) }] };
+        }
+        if (name === 'drdebug_get_interaction_replay') {
+            const replay = state.interactionsHuman || 'No interactions recorded.';
+            return { content: [{ type: 'text', text: replay }] };
+        }
+        if (name === 'drdebug_execute_script') {
+            try {
+                const res = await sendCommand({ type: 'EVAL_SCRIPT', expression: args.expression });
+                return { content: [{ type: 'text', text: JSON.stringify(res, null, 2) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: `Failed to evaluate in browser: ${err.message}` }], isError: true };
+            }
+        }
+        return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -0,0 +1,15 @@
+import type { BrowserTabTelemetry, MCPRequest, MCPResponse } from './types.js';
+import type { DockerBridge } from './DockerBridge.js';
+export declare class MCPTransport {
+    private server;
+    private port;
+    private sessions;
+    private dockerBridge?;
+    constructor(port?: number, dockerBridge?: DockerBridge);
+    setDockerBridge(dockerBridge: DockerBridge): void;
+    start(onRequest: (req: MCPRequest) => Promise<MCPResponse>, onStateUpdate?: (tabId: string, state: any) => void): Promise<void>;
+    sendCommandToBrowser(_command: any, _targetTabId?: string): Promise<any>;
+    getSessions(): Map<string, BrowserTabTelemetry>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,YAAY,CAAC,CAAc;gBAEvB,IAAI,SAAO,EAAE,YAAY,CAAC,EAAE,YAAY;IAK7C,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAIjD,KAAK,CACV,SAAS,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,EACpD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,GAClD,OAAO,CAAC,IAAI,CAAC;IA8LH,oBAAoB,CAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI9E,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAI/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAY7B"}

package/dist/transport.js

@@ -0,0 +1,203 @@
+import * as http from 'node:http';
+export class MCPTransport {
+    server = null;
+    port;
+    sessions = new Map();
+    dockerBridge;
+    constructor(port = 9229, dockerBridge) {
+        this.port = port;
+        this.dockerBridge = dockerBridge;
+    }
+    setDockerBridge(dockerBridge) {
+        this.dockerBridge = dockerBridge;
+    }
+    start(onRequest, onStateUpdate) {
+        return new Promise((resolve, reject) => {
+            try {
+                this.server = http.createServer(async (req, res) => {
+                    // CORS headers for browser and IDE access
+                    res.setHeader('Access-Control-Allow-Origin', '*');
+                    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+                    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+                    if (req.method === 'OPTIONS') {
+                        res.writeHead(204);
+                        res.end();
+                        return;
+                    }
+                    const url = req.url || '/';
+                    // 1. Browser Telemetry Ingestion (POST /telemetry or POST /browser)
+                    if (req.method === 'POST' && (url.startsWith('/telemetry') || url.startsWith('/browser'))) {
+                        let body = '';
+                        req.on('data', (chunk) => {
+                            body += chunk;
+                        });
+                        req.on('end', () => {
+                            try {
+                                const msg = JSON.parse(body);
+                                const tabId = msg.tabId || `tab_${Date.now()}`;
+                                if (msg.state) {
+                                    this.sessions.set(tabId, {
+                                        tabId,
+                                        url: msg.state?.pageContext?.url || 'Unknown',
+                                        title: msg.state?.pageContext?.title || 'Unknown Page',
+                                        lastSeen: Date.now(),
+                                        stateSnapshot: msg.state
+                                    });
+                                    onStateUpdate?.(tabId, msg.state);
+                                }
+                                res.writeHead(200, { 'Content-Type': 'application/json' });
+                                res.end(JSON.stringify({ status: 'ok', tabId }));
+                            }
+                            catch (err) {
+                                res.writeHead(400, { 'Content-Type': 'application/json' });
+                                res.end(JSON.stringify({ error: err.message }));
+                            }
+                        });
+                        return;
+                    }
+                    // 2. MCP JSON-RPC Endpoint (POST / or POST /mcp)
+                    if (req.method === 'POST') {
+                        let body = '';
+                        req.on('data', (chunk) => {
+                            body += chunk;
+                        });
+                        req.on('end', async () => {
+                            try {
+                                const mcpReq = JSON.parse(body);
+                                const mcpRes = await onRequest(mcpReq);
+                                res.writeHead(200, { 'Content-Type': 'application/json' });
+                                res.end(JSON.stringify(mcpRes));
+                            }
+                            catch (err) {
+                                res.writeHead(200, { 'Content-Type': 'application/json' });
+                                res.end(JSON.stringify({
+                                    jsonrpc: '2.0',
+                                    id: null,
+                                    error: { code: -32700, message: err.message || 'Parse error' }
+                                }));
+                            }
+                        });
+                        return;
+                    }
+                    // 3. Docker Endpoints
+                    if (url.startsWith('/docker/')) {
+                        if (!this.dockerBridge) {
+                            res.writeHead(503, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify({ error: 'Docker bridge not initialized on MCP daemon' }));
+                            return;
+                        }
+                        // A. Docker Status
+                        if (url === '/docker/status') {
+                            res.writeHead(200, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify(this.dockerBridge.getStatus()));
+                            return;
+                        }
+                        // B. Docker Containers
+                        if (url === '/docker/containers') {
+                            await this.dockerBridge.refreshContainers();
+                            res.writeHead(200, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify(this.dockerBridge.getContainers()));
+                            return;
+                        }
+                        // C. Docker Logs Query
+                        if (url.startsWith('/docker/logs')) {
+                            try {
+                                const parsedUrl = new URL(url, `http://localhost:${this.port}`);
+                                const container = parsedUrl.searchParams.get('container') || undefined;
+                                const level = parsedUrl.searchParams.get('level') || undefined;
+                                const grep = parsedUrl.searchParams.get('grep') || undefined;
+                                const tailStr = parsedUrl.searchParams.get('tail');
+                                const tail = tailStr ? parseInt(tailStr, 10) : 50;
+                                const logs = this.dockerBridge.getLogs({ container, level, grep, tail });
+                                res.writeHead(200, { 'Content-Type': 'application/json' });
+                                res.end(JSON.stringify(logs));
+                            }
+                            catch (err) {
+                                res.writeHead(400, { 'Content-Type': 'application/json' });
+                                res.end(JSON.stringify({ error: err.message }));
+                            }
+                            return;
+                        }
+                        // D. Real-Time Docker Event & Log SSE Stream
+                        if (url === '/docker/stream') {
+                            res.writeHead(200, {
+                                'Content-Type': 'text/event-stream',
+                                'Cache-Control': 'no-cache',
+                                Connection: 'keep-alive'
+                            });
+                            // Send initial state immediately
+                            const initPayload = {
+                                type: 'INIT',
+                                status: this.dockerBridge.getStatus(),
+                                containers: this.dockerBridge.getContainers(),
+                                recentLogs: this.dockerBridge.getLogs({ tail: 30 })
+                            };
+                            res.write(`data: ${JSON.stringify(initPayload)}\n\n`);
+                            const onLog = (entry) => {
+                                res.write(`data: ${JSON.stringify({ type: 'LOG', entry })}\n\n`);
+                            };
+                            const onContainers = (containers) => {
+                                res.write(`data: ${JSON.stringify({ type: 'CONTAINERS', containers })}\n\n`);
+                            };
+                            this.dockerBridge.on('log', onLog);
+                            this.dockerBridge.on('containers', onContainers);
+                            // Heartbeat keep-alive every 15s
+                            const heartbeat = setInterval(() => {
+                                res.write(`: ping\n\n`);
+                            }, 15000);
+                            req.on('close', () => {
+                                clearInterval(heartbeat);
+                                this.dockerBridge?.off('log', onLog);
+                                this.dockerBridge?.off('containers', onContainers);
+                            });
+                            return;
+                        }
+                    }
+                    // 4. Health & Discovery (GET /)
+                    if (req.method === 'GET') {
+                        res.writeHead(200, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({
+                            name: 'Dr. Debug MCP Server',
+                            status: 'running',
+                            sessions: Array.from(this.sessions.keys()),
+                            docker: this.dockerBridge ? this.dockerBridge.getStatus() : { isAvailable: false },
+                            timestamp: Date.now()
+                        }));
+                        return;
+                    }
+                    res.writeHead(404);
+                    res.end('Not Found');
+                });
+                this.server.listen(this.port, () => {
+                    resolve();
+                });
+                this.server.on('error', (err) => {
+                    reject(err);
+                });
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    async sendCommandToBrowser(_command, _targetTabId) {
+        return { status: 'acknowledged', note: 'Browser command dispatched' };
+    }
+    getSessions() {
+        return this.sessions;
+    }
+    stop() {
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.close(() => {
+                    this.server = null;
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+export interface MCPResource {
+    uri: string;
+    name: string;
+    mimeType: string;
+    description: string;
+}
+export interface MCPResourceContent {
+    uri: string;
+    mimeType: string;
+    text?: string;
+    blob?: string;
+}
+export interface MCPToolParameter {
+    type: string;
+    description?: string;
+    enum?: string[];
+    properties?: Record<string, any>;
+    required?: string[];
+}
+export interface MCPToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+export interface MCPRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: any;
+}
+export interface MCPResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: any;
+    error?: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+}
+export interface BrowserTabTelemetry {
+    tabId: string;
+    url: string;
+    title: string;
+    lastSeen: number;
+    stateSnapshot: any;
+}
+export type LogLevel = 'error' | 'warn' | 'info' | 'log';
+export interface DockerContainerInfo {
+    id: string;
+    name: string;
+    image: string;
+    state: 'running' | 'exited' | 'restarting' | 'paused' | string;
+    status: string;
+    ports?: string[];
+}
+export interface DockerLogEntry {
+    id: string;
+    containerName: string;
+    timestamp: number;
+    stream: 'stdout' | 'stderr';
+    message: string;
+    level: LogLevel;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KACpB,CAAA;CACF;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,GAAG,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAA;IACd,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,GAAG,CAAA;KACX,CAAA;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,GAAG,CAAA;CACnB;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;AAExD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC9D,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,CAAA;CAChB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@dr-debug/mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol (MCP) server & IDE bridge for Dr. Debug",
+  "type": "module",
+  "bin": {
+    "dr-debug-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "start": "node dist/cli.js"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.2"
+  },
+  "author": "Saswat Mohanty (https://github.com/SazWhatician)",
+  "homepage": "https://github.com/SazWhatician",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SazWhatician/DebugCopilot"
+  },
+  "license": "MIT"
+}