KX

koriym/xdebug-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

64 stars 9 forks 품질 66 트렌드 34

Xdebug와 PHP를 디버깅할 수 있는 AI

개요

PHP에 대한 추적 기반 디버깅, Xdebug에 내장. CLI에서 도구를 구동하거나 AI Assistant가 플러그인, 기술 또는 MCP 통합을 통해 핵심 도구를 실행할 수 있습니다. 당신이 원하는 당신의 AI 조수에게 말하십시오: 플러그인, 스킬 또는 MCP-capable 클라이언트를 통해 연결하면 AI는 적절한 도구를 선택하고 결과를 분석 할 수 있습니다. - PHP 8.2+ - Xdebug 3.x extension (installed, but enable by default) - 선택 사항 : AI Assistant (Claude Code plugin, Codex Skill 또는 MCP-capable client) 매일 사용을 위해 php.ini에서 Xdebug를 비활성화하십시오. 이 도구는 필요한 경우 Xdebug on-demand를로드합니다. 두 개의 통합이 가능합니다. : 이 도구는 디자인에 의해 stateless one-shot CLI 명령이므로 에이전트가 직접 실행하여 Skills의 사용 노트에 의해 안내하는 것이 가장 간단하고 정확한 경로입니다. 클라이언트가 포탄 접근 또는 기술 지원이 없을 때 MCP를 선택하십시오.

개요(AI 번역)

런타임 데이터와 디버그 PHP — var dump(), Guesswork

PHP에 대한 추적 기반 디버깅, Xdebug에 내장. CLI에서 도구를 구동하거나 AI Assistant가 플러그인, 기술 또는 MCP 통합을 통해 핵심 도구를 실행할 수 있습니다.

  • 없음)

자연 언어 Debugging

당신이 원하는 당신의 AI 조수에게 말하십시오:

영어:

日本語:

플러그인, 스킬 또는 MCP-capable 클라이언트를 통해 연결하면 AI는 적절한 도구를 선택하고 결과를 분석 할 수 있습니다.

요구 사항

  • PHP 8.2 이상
  • Xdebug 3.x 확장 (설치되었지만 ** 기본적으로 활성화되지 않음)
  • 선택 사항 : AI 조수 (Claude Code 플러그인, Codex Skill 또는 MCP-capable client)

** 성능 팁:** 매일 사용 php.ini에서 Xdebug를 비활성화하십시오. 이 도구는 필요한 경우 Xdebug on-demand를로드합니다.

빠른 시작

##1. 설치

##2. Xdebug를 검증

##3. (선택 사항) AI 조수

두 개의 통합이 가능합니다. ** 우리는 Skill**을 추천합니다: 이 도구는 디자인에 의해 stateless one-shot CLI 명령이므로 에이전트가 직접 실행하여 Skill의 사용 노트에 의해 안내합니다. — 가장 간단하고 정확한 경로입니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Xdebug MCP

Debug PHP with Runtime Data — No var_dump(), No Guesswork

Trace-based debugging for PHP, built on Xdebug. Drive the tools from the CLI, or let an AI assistant run the core tools through plugin, Skill, or MCP integration.


Natural Language Debugging

Just tell your AI assistant what you want:

English:

"Debug script.php and find why $user is null at line 42"
"Profile api.php and find the performance bottleneck"
"Trace the authentication flow in login.php"
"Check test coverage for UserService"

日本語:

"script.phpをデバッグして、42行目で$userがnullになる原因を調べて"
"api.phpのパフォーマンスボトルネックを見つけて"
"login.phpの認証フローをトレースして"
"UserServiceのテストカバレッジを確認して"

When connected through the plugin, Skill, or an MCP-capable client, the AI can select the appropriate tool, execute it, and analyze the results.

Requirements

  • PHP 8.2+
  • Xdebug 3.x extension (installed, but not enabled by default)
  • Optional: an AI assistant (Claude Code plugin, Codex Skill, or any MCP-capable client)

💡 Performance Tip: Keep Xdebug disabled in php.ini for daily use. This tool loads Xdebug on-demand only when needed.

Quick Start

1. Install

composer global require koriym/xdebug-mcp

2. Verify Xdebug

"$(composer global config bin-dir --absolute --quiet)/check-env"

3. (Optional) Wire up an AI assistant

Two integrations are available. We recommend the Skill: these tools are stateless one-shot CLI commands by design, so letting the agent run them directly — guided by the Skill’s usage notes — is the simplest and most accurate path. Choose MCP when your client has no shell access or no Skill support.

Skill (recommended) MCP server
How it works The agent reads SKILL.md and runs the CLI tools directly The client calls the tools over JSON-RPC (stdio)
Setup Plugin install, or copy one directory Register in the client’s MCP config
Best for AI coding agents with shell access (Claude Code, Codex, …) MCP-capable clients without shell/Skill support (e.g. Claude Desktop)

Claude Code — install the plugin (which bundles the Skill):

/plugin marketplace add koriym/xdebug-mcp
/plugin install xdebug@xdebug-mcp

Codex CLI — install the Skill:

git clone --depth 1 https://github.com/koriym/xdebug-mcp.git /tmp/xdebug-mcp
mkdir -p ~/.codex/skills
cp -r /tmp/xdebug-mcp/skills/xdebug ~/.codex/skills/

Any MCP-capable client — see MCP Configuration below.

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "xdebug": { "command": "php", "args": ["/ABSOLUTE/PATH/TO/xdebug-mcp"] } } }