Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.kpanuragh/xdebug

NPM · XDEBUG-MCP · SCANNED SEP 24

MCP server for PHP Xdebug debugging with breakpoints, stepping, and variable inspection

Available components

0 this week 78 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security88
  • No malware found by supply-chain analysis.Pass
  • CVE check failed: a known medium-severity CVE affects fast-xml-parser 4.5.7, a direct dependency. A fixed version is available. View diagnostics → Fail
  • No install/post-install scripts declared.Pass
  • 31 of 98 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 22 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability76
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 2119 tokens (~46/item across 46 items; 46 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management83
  • Stability observed for 25 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "remove_breakpoint" implies "remove" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
  • An AI judge read all 46 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

How do I install the io.github.kpanuragh/xdebug MCP server?

io.github.kpanuragh/xdebug runs locally as an npm package, launched with npx -y xdebug-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · xdebug-mcp

# add to Claude Code
claude mcp add kpanuragh-xdebug -- npx -y xdebug-mcp
// .cursor/mcp.json
{
  "mcpServers": {
    "kpanuragh-xdebug": {
      "command": "npx",
      "args": [
        "-y",
        "xdebug-mcp"
      ]
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "kpanuragh-xdebug": {
      "command": "npx",
      "args": [
        "-y",
        "xdebug-mcp"
      ]
    }
  }
}
# add to Codex CLI
codex mcp add kpanuragh-xdebug -- npx -y xdebug-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kpanuragh-xdebug": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "xdebug-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add kpanuragh-xdebug --command npx --arg -y --arg xdebug-mcp
# ~/.hermes/config.yaml
mcp_servers:
  kpanuragh-xdebug:
    command: "npx"
    args: ["-y", "xdebug-mcp"]
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "kpanuragh-xdebug": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "xdebug-mcp"
      ]
    }
  }
}
# add to Vellum
assistant mcp add kpanuragh-xdebug -t stdio -c npx -a -y xdebug-mcp
// mcp.json
{
  "mcpServers": {
    "kpanuragh-xdebug": {
      "command": "npx",
      "args": [
        "-y",
        "xdebug-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 24 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.

  • 23 Sept 26 −3
    • Stability: pass → 0.80 functional
  • 22 Sept 26 0
    • Stability: 0.97 → pass security
  • 21 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

  • 19 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

  • 17 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.

  • 16 Sept 26 −3
    • Stability: pass → 0.80 functional
  • 15 Sept 26 0
    • Stability: 0.97 → pass security
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 24 Sept 2026 · Analysed npm/xdebug-mcp@1.2.1

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm

Background: How many MCP packages publish verified provenance →

Vulnerabilities 1 finding
ID CVE Severity Vector Fix available
GHSA-gh4j-gqv2-49f6 CVE-2026-41650 medium CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:C/C:L/I:L/A:N yes

Background: What a vulnerability scan can and cannot prove →

Dependencies 98 packages
Packages resolved 98
Stale 31
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 46 exposed · ~2,119 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
add_logpoint ~82

Add a logpoint that logs messages without stopping execution. Use {varName} placeholders for variables.

NameTypeReqDescription
conditionstring–Optional condition
filestringyesFile path
lineintegeryesLine number
messagestringyesMessage template with {var} placeholders (e.g., 'User {$userId} logged in')

No output schema declared.

No examples provided.

add_step_filter ~77

Add a step filter to skip certain files/directories during stepping (e.g., vendor code)

NameTypeReqDescription
descriptionstring–Description of the filter
patternstringyesPattern to match (e.g., '/vendor/', '*.min.js', '/regex/')
typestringyesinclude = step into, exclude = skip

No output schema declared.

No examples provided.

add_watch ~50

Add a watch expression that will be evaluated on each break. Watch expressions persist across steps.

NameTypeReqDescription
expressionstringyesPHP expression to watch (e.g., '$user->id', 'count($items)')

No output schema declared.

No examples provided.

capture_request_context ~39

Capture the current HTTP request context ($_GET, $_POST, $_SESSION, $_COOKIE, headers)

NameTypeReqDescription
session_idstring–Session ID

No output schema declared.

No examples provided.

capture_snapshot ~31

Capture a snapshot of the current debug state for the export report

NameTypeReqDescription
session_idstring–Session ID

No output schema declared.

No examples provided.

close_session ~34

Close and terminate a debug session

NameTypeReqDescription
session_idstring–Session ID to close (uses active session if not specified)

No output schema declared.

No examples provided.

continue ~29

Continue script execution until the next breakpoint or end of script

NameTypeReqDescription
session_idstring–Session ID

No output schema declared.

No examples provided.

detach ~32

Detach from the debug session and let the script continue running without debugging

NameTypeReqDescription
session_idstring–Session ID

No output schema declared.

No examples provided.

evaluate ~93

Evaluate a PHP expression in the current context. Returns the result of the expression. Use for calculations, method calls, or inspecting computed values.

NameTypeReqDescription
expressionstringyesPHP expression to evaluate (e.g., '$x + $y', 'count($array)', '$user->getName()', 'array_keys($data)')
session_idstring–Session ID
stack_depthinteger–Stack frame depth

No output schema declared.

No examples provided.

evaluate_watches ~29

Evaluate all watch expressions and return their current values

NameTypeReqDescription
session_idstring–Session ID

No output schema declared.

No examples provided.

export_session ~36

Export the current debug session as a report

NameTypeReqDescription
formatstring–Export format
session_idstring–Session ID

No output schema declared.

No examples provided.

get_contexts ~54

Get available variable contexts (Local, Superglobals, User-defined constants) at the current position

NameTypeReqDescription
session_idstring–Session ID
stack_depthinteger–Stack frame depth (0 = current frame)

No output schema declared.

No examples provided.

get_coverage_report ~17

Get the current code coverage report

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_function_history ~39

Get the history of function calls made during debugging

NameTypeReqDescription
limitinteger–Maximum entries
searchstring–Search query to filter

No output schema declared.

No examples provided.

get_logpoint_history ~48

Get the log output history from logpoints

NameTypeReqDescription
limitinteger–Maximum entries to return
logpoint_idstring–Specific logpoint ID (all if not specified)

No output schema declared.

No examples provided.

get_memory_timeline ~17

Get memory usage timeline from profiling

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_profile_stats ~14

Get current profiling statistics

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_session_state ~40

Get detailed state of a specific debug session including current position and status

NameTypeReqDescription
session_idstring–Session ID (uses active session if not specified)

No output schema declared.

No examples provided.

get_source ~66

Get the source code of a file or a specific line range

NameTypeReqDescription
begin_lineinteger–Starting line number
end_lineinteger–Ending line number
filestringyesFile path to get source from
session_idstring–Session ID

No output schema declared.

No examples provided.

get_stack_trace ~34

Get the current call stack showing all function calls leading to the current position

NameTypeReqDescription
session_idstring–Session ID

No output schema declared.

No examples provided.

get_variable ~121

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')

NameTypeReqDescription
context_idinteger–Context ID
max_depthinteger–Maximum depth for nested properties
namestringyesVariable name with $ prefix (e.g., '$user', '$data["key"]', '$obj->property')
session_idstring–Session ID
stack_depthinteger–Stack frame depth

No output schema declared.

No examples provided.

get_variables ~96

List all variables in scope with metadata (names, types, child counts). Use get_variable() to inspect specific variable values. Returns lightweight metadata for browsing the variable tree.

NameTypeReqDescription
context_idinteger–Context ID: 0=Local variables, 1=Superglobals, 2=User constants
session_idstring–Session ID
stack_depthinteger–Stack frame depth (0 = current frame)

No output schema declared.

No examples provided.

list_breakpoints ~49

List all breakpoints including both active session breakpoints and pending breakpoints

NameTypeReqDescription
include_pendingboolean–Include pending breakpoints in the list
session_idstring–Session ID

No output schema declared.

No examples provided.

list_debug_profiles ~15

List all saved debug profiles

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_sessions ~19

List all active PHP debug sessions with their current state

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_step_filters ~15

List all step filter rules

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_watches ~15

List all active watch expressions

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

load_debug_profile ~26

Load a saved debug profile

NameTypeReqDescription
namestringyesProfile name to load

No output schema declared.

No examples provided.

remove_breakpoint ~59

Remove a breakpoint by its ID. Works for both active session breakpoints and pending breakpoints.

NameTypeReqDescription
breakpoint_idstringyesThe breakpoint ID to remove (session breakpoint ID or pending_* ID)
session_idstring–Session ID

No output schema declared.

No examples provided.

remove_logpoint ~26

Remove a logpoint

NameTypeReqDescription
logpoint_idstringyesLogpoint ID

No output schema declared.

No examples provided.

remove_watch ~25

Remove a watch expression

NameTypeReqDescription
watch_idstringyesWatch ID to remove

No output schema declared.

No examples provided.

save_debug_profile ~45

Save the current debug configuration (breakpoints, watches, filters) as a named profile

NameTypeReqDescription
descriptionstring–Profile description
namestringyesProfile name

No output schema declared.

No examples provided.

set_active_session ~37

Set which debug session should be the active/default session for subsequent commands

NameTypeReqDescription
session_idstringyesSession ID to set as active

No output schema declared.

No examples provided.

set_breakpoint ~177

Set a breakpoint in PHP code. Supports line breakpoints and conditional breakpoints with hit counts. Can be set before a debug session starts - breakpoints will be applied when a session connects.

NameTypeReqDescription
conditionstring–Optional PHP condition expression (e.g., '$x > 10' or '$user !== null')
filestringyesFull file path (use container path for Docker, e.g., /var/www/html/index.php)
hit_conditionstring–Hit condition: >= (break when hits >= value), == (break on exact hit), % (break every N hits)
hit_valueinteger–Hit count value - break after this many hits
lineintegeryesLine number for the breakpoint
session_idstring–Session ID (uses active session if not specified)

No output schema declared.

No examples provided.

set_call_breakpoint ~69

Set a breakpoint that triggers when a specific function is called. Can be set before a debug session starts.

NameTypeReqDescription
function_namestringyesFunction name to break on (e.g., 'myFunction' or 'MyClass::myMethod')
session_idstring–Session ID

No output schema declared.

No examples provided.

set_exception_breakpoint ~67

Set a breakpoint that triggers when a specific exception is thrown. Can be set before a debug session starts.

NameTypeReqDescription
exceptionstring–Exception class name to break on (use '*' for all exceptions, or specific like 'RuntimeException')
session_idstring–Session ID

No output schema declared.

No examples provided.

set_variable ~96

Set the value of a variable in the current scope

NameTypeReqDescription
context_idinteger–Context ID
namestringyesVariable name (e.g., $x, $user->name)
session_idstring–Session ID
stack_depthinteger–Stack frame depth
valuestringyesNew value as a PHP literal (e.g., 42, "hello", true, null)

No output schema declared.

No examples provided.

start_coverage ~16

Start tracking code coverage during debugging

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

start_profiling ~20

Start profiling to track memory usage and execution time

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

step_into ~43

Step into the next function call, or to the next line if not a function call. This follows execution into called functions.

NameTypeReqDescription
session_idstring–Session ID

No output schema declared.

No examples provided.

step_out ~33

Step out of the current function. Execution continues until the current function returns.

NameTypeReqDescription
session_idstring–Session ID

No output schema declared.

No examples provided.

step_over ~38

Step over to the next line in the current scope. Function calls are executed but not stepped into.

NameTypeReqDescription
session_idstring–Session ID

No output schema declared.

No examples provided.

stop ~27

Stop the debug session and terminate script execution immediately

NameTypeReqDescription
session_idstring–Session ID

No output schema declared.

No examples provided.

stop_coverage ~18

Stop tracking code coverage and get the report

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

stop_profiling ~17

Stop profiling and get the results

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

update_breakpoint ~89

Update a breakpoint (enable/disable or change hit conditions). Works for both active session and pending breakpoints.

NameTypeReqDescription
breakpoint_idstringyesThe breakpoint ID to update
hit_conditionstring–New hit condition
hit_valueinteger–New hit count value
session_idstring–Session ID
statestring–Enable or disable the breakpoint

No output schema declared.

No examples provided.

Common questions

What is the io.github.kpanuragh/xdebug MCP server?

io.github.kpanuragh/xdebug is an MCP server listed in the public MCP registry as io.github.kpanuragh/xdebug. MCP server for PHP Xdebug debugging with breakpoints, stepping, and variable inspection. This page covers its npm package (xdebug-mcp).

Is the io.github.kpanuragh/xdebug MCP server safe to use?

io.github.kpanuragh/xdebug scores 78 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 24 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the io.github.kpanuragh/xdebug MCP server expose?

io.github.kpanuragh/xdebug exposes 46 tools: list_sessions, get_session_state, set_active_session, close_session, set_breakpoint, and 41 more. Their descriptions and schemas cost roughly 2,119 tokens of context every time the server is loaded.

Is the io.github.kpanuragh/xdebug MCP server still maintained?

io.github.kpanuragh/xdebug is still listed as active in the MCP registry. We last reached this channel on 24 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the io.github.kpanuragh/xdebug MCP server under?

io.github.kpanuragh/xdebug declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.