xdebug-mcp 1.0.0

package/dist/tools/index.js

@@ -0,0 +1,44 @@
+/**
+ * MCP Tool Registration
+ */
+import { WatchManager } from '../session/watch-manager.js';
+import { LogpointManager } from '../session/logpoint-manager.js';
+import { Profiler } from '../session/profiler.js';
+import { RequestContextCapture } from '../session/request-context.js';
+import { StepFilter } from '../session/step-filter.js';
+import { DebugConfigManager } from '../session/debug-config.js';
+import { CodeCoverageTracker } from '../session/code-coverage.js';
+import { SessionExporter } from '../session/session-export.js';
+import { registerSessionTools } from './session.js';
+import { registerBreakpointTools } from './breakpoints.js';
+import { registerExecutionTools } from './execution.js';
+import { registerInspectionTools } from './inspection.js';
+import { registerAdvancedTools } from './advanced.js';
+export function createToolsContext(sessionManager) {
+    return {
+        sessionManager,
+        watchManager: new WatchManager(),
+        logpointManager: new LogpointManager(),
+        profiler: new Profiler(),
+        requestCapture: new RequestContextCapture(),
+        stepFilter: new StepFilter(),
+        configManager: new DebugConfigManager(),
+        coverageTracker: new CodeCoverageTracker(),
+        sessionExporter: new SessionExporter(),
+    };
+}
+export function registerAllTools(server, ctx) {
+    // Core debugging tools
+    registerSessionTools(server, ctx.sessionManager);
+    registerBreakpointTools(server, ctx.sessionManager);
+    registerExecutionTools(server, ctx.sessionManager);
+    registerInspectionTools(server, ctx.sessionManager);
+    // Advanced tools
+    registerAdvancedTools(server, ctx);
+}
+export { registerSessionTools } from './session.js';
+export { registerBreakpointTools } from './breakpoints.js';
+export { registerExecutionTools } from './execution.js';
+export { registerInspectionTools } from './inspection.js';
+export { registerAdvancedTools } from './advanced.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAwB,MAAM,eAAe,CAAC;AAc5E,MAAM,UAAU,kBAAkB,CAAC,cAA8B;IAC/D,OAAO;QACL,cAAc;QACd,YAAY,EAAE,IAAI,YAAY,EAAE;QAChC,eAAe,EAAE,IAAI,eAAe,EAAE;QACtC,QAAQ,EAAE,IAAI,QAAQ,EAAE;QACxB,cAAc,EAAE,IAAI,qBAAqB,EAAE;QAC3C,UAAU,EAAE,IAAI,UAAU,EAAE;QAC5B,aAAa,EAAE,IAAI,kBAAkB,EAAE;QACvC,eAAe,EAAE,IAAI,mBAAmB,EAAE;QAC1C,eAAe,EAAE,IAAI,eAAe,EAAE;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAAiB,EACjB,GAAiB;IAEjB,uBAAuB;IACvB,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IACjD,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IACpD,sBAAsB,CAAC,MAAM,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IACnD,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAEpD,iBAAiB;IACjB,qBAAqB,CAAC,MAAM,EAAE,GAA2B,CAAC,CAAC;AAC7D,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/inspection.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Inspection MCP Tools
+ * Tools for inspecting variables, stack traces, and evaluating expressions.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SessionManager } from '../session/manager.js';
+export declare function registerInspectionTools(server: McpServer, sessionManager: SessionManager): void;

package/dist/tools/inspection.js

@@ -0,0 +1,431 @@
+/**
+ * Inspection MCP Tools
+ * Tools for inspecting variables, stack traces, and evaluating expressions.
+ */
+import { z } from 'zod';
+// Helper to format property for output
+function formatProperty(prop, depth = 0) {
+    const result = {
+        name: prop.name,
+        type: prop.type,
+    };
+    if (prop.classname)
+        result.classname = prop.classname;
+    if (prop.value !== undefined)
+        result.value = prop.value;
+    if (prop.numchildren !== undefined && prop.numchildren > 0) {
+        result.numchildren = prop.numchildren;
+    }
+    if (prop.constant)
+        result.constant = true;
+    // Include nested properties if present and not too deep
+    if (prop.properties && prop.properties.length > 0 && depth < 3) {
+        result.children = prop.properties.map((p) => formatProperty(p, depth + 1));
+    }
+    return result;
+}
+export function registerInspectionTools(server, sessionManager) {
+    // Get stack trace
+    server.tool('get_stack_trace', 'Get the current call stack showing all function calls leading to the current position', {
+        session_id: z.string().optional().describe('Session ID'),
+    }, async ({ session_id }) => {
+        const session = sessionManager.resolveSession(session_id);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: 'No active debug session' }),
+                    },
+                ],
+            };
+        }
+        try {
+            const frames = await session.getStackTrace();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            stack: frames.map((frame) => ({
+                                level: frame.level,
+                                file: frame.filename,
+                                line: frame.lineno,
+                                where: frame.where || '(main)',
+                                type: frame.type,
+                            })),
+                            depth: frames.length,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to get stack trace',
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    // Get available contexts
+    server.tool('get_contexts', 'Get available variable contexts (Local, Superglobals, User-defined constants) at the current position', {
+        stack_depth: z
+            .number()
+            .int()
+            .default(0)
+            .describe('Stack frame depth (0 = current frame)'),
+        session_id: z.string().optional().describe('Session ID'),
+    }, async ({ stack_depth, session_id }) => {
+        const session = sessionManager.resolveSession(session_id);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: 'No active debug session' }),
+                    },
+                ],
+            };
+        }
+        try {
+            const contexts = await session.getContexts(stack_depth);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            contexts: contexts.map((ctx) => ({
+                                id: ctx.id,
+                                name: ctx.name,
+                            })),
+                            hint: 'Use context_id in get_variables to get variables from a specific context',
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to get contexts',
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    // Get all variables in scope
+    server.tool('get_variables', 'Get all variables at the current execution point. Use context_id to switch between local variables, superglobals, etc.', {
+        context_id: z
+            .number()
+            .int()
+            .default(0)
+            .describe('Context ID: 0=Local variables, 1=Superglobals, 2=User constants'),
+        stack_depth: z
+            .number()
+            .int()
+            .default(0)
+            .describe('Stack frame depth (0 = current frame)'),
+        session_id: z.string().optional().describe('Session ID'),
+    }, async ({ context_id, stack_depth, session_id }) => {
+        const session = sessionManager.resolveSession(session_id);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: 'No active debug session' }),
+                    },
+                ],
+            };
+        }
+        try {
+            const variables = await session.getVariables(context_id, stack_depth);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            variables: variables.map((v) => formatProperty(v)),
+                            count: variables.length,
+                            context_id,
+                            stack_depth,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to get variables',
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    // Get a specific variable
+    server.tool('get_variable', "Get a specific variable by name, including nested properties. Use PHP syntax for nested access (e.g., '$user->name', '$array[0]', '$obj->items[2]->value')", {
+        name: z
+            .string()
+            .describe("Variable name with $ prefix (e.g., '$user', '$data[\"key\"]', '$obj->property')"),
+        context_id: z.number().int().default(0).describe('Context ID'),
+        stack_depth: z.number().int().default(0).describe('Stack frame depth'),
+        max_depth: z
+            .number()
+            .int()
+            .default(2)
+            .describe('Maximum depth for nested properties'),
+        session_id: z.string().optional().describe('Session ID'),
+    }, async ({ name, context_id, stack_depth, max_depth, session_id }) => {
+        const session = sessionManager.resolveSession(session_id);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: 'No active debug session' }),
+                    },
+                ],
+            };
+        }
+        try {
+            const variable = await session.getVariable(name, {
+                contextId: context_id,
+                stackDepth: stack_depth,
+                maxDepth: max_depth,
+            });
+            if (!variable) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'Variable not found',
+                                name,
+                                message: `Variable "${name}" does not exist in the current scope`,
+                            }),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            variable: formatProperty(variable),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to get variable',
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    // Set a variable value
+    server.tool('set_variable', 'Set the value of a variable in the current scope', {
+        name: z.string().describe('Variable name (e.g., $x, $user->name)'),
+        value: z.string().describe('New value as a PHP literal (e.g., 42, "hello", true, null)'),
+        context_id: z.number().int().default(0).describe('Context ID'),
+        stack_depth: z.number().int().default(0).describe('Stack frame depth'),
+        session_id: z.string().optional().describe('Session ID'),
+    }, async ({ name, value, context_id, stack_depth, session_id }) => {
+        const session = sessionManager.resolveSession(session_id);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: 'No active debug session' }),
+                    },
+                ],
+            };
+        }
+        try {
+            const success = await session.setVariable(name, value, {
+                contextId: context_id,
+                stackDepth: stack_depth,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success,
+                            name,
+                            value,
+                            message: success
+                                ? `Variable ${name} set to ${value}`
+                                : 'Failed to set variable',
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to set variable',
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    // Evaluate an expression
+    server.tool('evaluate', "Evaluate a PHP expression in the current context. Returns the result of the expression. Use for calculations, method calls, or inspecting computed values.", {
+        expression: z
+            .string()
+            .describe("PHP expression to evaluate (e.g., '$x + $y', 'count($array)', '$user->getName()', 'array_keys($data)')"),
+        stack_depth: z.number().int().default(0).describe('Stack frame depth'),
+        session_id: z.string().optional().describe('Session ID'),
+    }, async ({ expression, stack_depth, session_id }) => {
+        const session = sessionManager.resolveSession(session_id);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: 'No active debug session' }),
+                    },
+                ],
+            };
+        }
+        try {
+            const result = await session.evaluate(expression, stack_depth);
+            if (!result) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'Evaluation returned no result',
+                                expression,
+                            }),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            expression,
+                            result: formatProperty(result),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Evaluation failed',
+                            expression,
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+    // Get source code
+    server.tool('get_source', 'Get the source code of a file or a specific line range', {
+        file: z.string().describe('File path to get source from'),
+        begin_line: z.number().int().optional().describe('Starting line number'),
+        end_line: z.number().int().optional().describe('Ending line number'),
+        session_id: z.string().optional().describe('Session ID'),
+    }, async ({ file, begin_line, end_line, session_id }) => {
+        const session = sessionManager.resolveSession(session_id);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: 'No active debug session' }),
+                    },
+                ],
+            };
+        }
+        try {
+            const source = await session.getSource(file, begin_line, end_line);
+            if (source === null) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'Failed to get source',
+                                file,
+                                message: 'File not found or not accessible',
+                            }),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            file,
+                            beginLine: begin_line,
+                            endLine: end_line,
+                            source,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to get source',
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=inspection.js.map

package/dist/tools/inspection.js.map

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

package/dist/tools/session.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Session Management MCP Tools
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SessionManager } from '../session/manager.js';
+export declare function registerSessionTools(server: McpServer, sessionManager: SessionManager): void;

package/dist/tools/session.js

@@ -0,0 +1,164 @@
+/**
+ * Session Management MCP Tools
+ */
+import { z } from 'zod';
+export function registerSessionTools(server, sessionManager) {
+    // List all active debug sessions
+    server.tool('list_sessions', 'List all active PHP debug sessions with their current state', {}, async () => {
+        const sessions = sessionManager.getAllSessions();
+        const activeId = sessionManager.getActiveSessionId();
+        const sessionData = sessions.map((s) => {
+            const state = s.getState();
+            return {
+                id: s.id,
+                active: s.id === activeId,
+                status: state.status,
+                file: s.initPacket?.fileUri || 'unknown',
+                currentFile: state.filename,
+                currentLine: state.lineno,
+                ideKey: s.initPacket?.ideKey || 'unknown',
+                language: s.initPacket?.language || 'PHP',
+                startTime: state.startTime.toISOString(),
+            };
+        });
+        if (sessionData.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            sessions: [],
+                            message: 'No active debug sessions. Start a PHP script with Xdebug enabled to begin debugging.',
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ sessions: sessionData, count: sessionData.length }, null, 2),
+                },
+            ],
+        };
+    });
+    // Get detailed session state
+    server.tool('get_session_state', 'Get detailed state of a specific debug session including current position and status', {
+        session_id: z
+            .string()
+            .optional()
+            .describe('Session ID (uses active session if not specified)'),
+    }, async ({ session_id }) => {
+        const session = sessionManager.resolveSession(session_id);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'No session found',
+                            message: session_id
+                                ? `Session "${session_id}" not found`
+                                : 'No active debug session. Start a PHP script with Xdebug enabled.',
+                        }),
+                    },
+                ],
+            };
+        }
+        const state = session.getState();
+        const initPacket = session.initPacket;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        id: session.id,
+                        status: state.status,
+                        currentFile: state.filename,
+                        currentLine: state.lineno,
+                        startTime: state.startTime.toISOString(),
+                        init: initPacket
+                            ? {
+                                fileUri: initPacket.fileUri,
+                                ideKey: initPacket.ideKey,
+                                language: initPacket.language,
+                                protocolVersion: initPacket.protocolVersion,
+                                engine: initPacket.engine,
+                            }
+                            : null,
+                        isConnected: session.isConnected,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    // Set active session
+    server.tool('set_active_session', 'Set which debug session should be the active/default session for subsequent commands', {
+        session_id: z.string().describe('Session ID to set as active'),
+    }, async ({ session_id }) => {
+        const success = sessionManager.setActiveSession(session_id);
+        if (!success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Session not found',
+                            session_id,
+                        }),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: `Session "${session_id}" is now active`,
+                    }),
+                },
+            ],
+        };
+    });
+    // Close a session
+    server.tool('close_session', 'Close and terminate a debug session', {
+        session_id: z
+            .string()
+            .optional()
+            .describe('Session ID to close (uses active session if not specified)'),
+    }, async ({ session_id }) => {
+        const session = sessionManager.resolveSession(session_id);
+        if (!session) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'No session found',
+                            message: session_id
+                                ? `Session "${session_id}" not found`
+                                : 'No active debug session',
+                        }),
+                    },
+                ],
+            };
+        }
+        const closedId = session.id;
+        sessionManager.closeSession(closedId);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: `Session "${closedId}" closed`,
+                    }),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=session.js.map