How do I connect Xdebug MCP Server to Claude?

Run `claude mcp add xdebug-mcp -- npx -y xdebug-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Xdebug MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Xdebug MCP Server do?

Xdebug MCP Server documents 40 tools to the agent, including add_logpoint, add_watch, close_session. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Xdebug MCP

Unclaimed

by kpanuragh

MCP server for PHP Xdebug debugging - enables AI-assisted PHP debugging through the Model Context Protocol with Unix socket and TCP support

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'xdebug-mcp' -- 'npx' '-y' 'xdebug-mcp'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

aiclaudedbgpdebuggingmcpphpunix-socketxdebug

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

40 of 40 tools

Documented tools (40)

From project documentation. A server handshake does not verify each tool’s description or behavior.

add_logpoint

Add a logpoint with message template

add_watch

Add a persistent watch expression

close_session

Close a debug session

continue

Continue to next breakpoint

detach

Detach and let script continue

evaluate

Evaluate a PHP expression

evaluate_watches

Evaluate all watches and detect changes

get_contexts

Get available variable contexts

get_coverage_report

View coverage statistics

get_logpoint_history

View log output and hit statistics

get_memory_timeline

View memory usage over time

get_profile_stats

Get current profiling statistics

get_session_state

Get detailed state of a session

get_source

Get source code

get_stack_trace

Get the call stack

get_variable

Get a specific variable

get_variables

Get all variables in scope

list_breakpoints

List all breakpoints including pending

list_debug_profiles

List all saved profiles

list_sessions

List all active debug sessions

list_watches

List all active watches

load_debug_profile

Load a saved debug profile

remove_breakpoint

Remove a breakpoint (works with pending breakpoints)

remove_logpoint

Remove a logpoint

remove_watch

Remove a watch expression

save_debug_profile

Save current configuration as a profile

set_active_session

Set which session is active

set_breakpoint

Set a line or conditional breakpoint (supports pending breakpoints)

set_call_breakpoint

Break on function calls (supports pending breakpoints)

set_exception_breakpoint

Break on exceptions (supports pending breakpoints)

set_variable

Set a variable's value

start_coverage

Start tracking code coverage

start_profiling

Start memory/time profiling

step_into

Step into function calls

step_out

Step out of current function

step_over

Step over (skip function internals)

stop

Stop debugging

stop_coverage

Stop and get coverage report

stop_profiling

Stop profiling and get results

update_breakpoint

Enable/disable or modify a breakpoint

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Xdebug MCP Server

How do I connect Xdebug MCP Server to Claude?: Run `claude mcp add xdebug-mcp -- npx -y xdebug-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Xdebug MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Xdebug MCP Server do?: Xdebug MCP Server documents 40 tools to the agent, including add_logpoint, add_watch, close_session. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.