HOBER-EST/mcp-debugger

mcp-debugger은(는) 무엇을 하나요?

Claude Code 스킬로, MCP 서버 설정 문제를 진단하고 수정합니다.

개요

이 스킬은 MCP(Model Context Protocol) 서버 설정 문제를 자동으로 진단하고 수정 가이드를 제공합니다.

사용 방법

# MCP 설정 검사
mcp-debug check

# 특정 서버 진단
mcp-debug diagnose <server-name>

주요 기능

• 설정 파일 구문 검사
• 필수 필드 누락 확인
• 파일 경로 유효성 검사
• 환경 변수 누락 감지
• 의존성 설치 상태 확인
• 수정 제안 생성

지원 플랫폼

• Claude Code
• Cursor
• Codex

설정 예시

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "API_KEY": "${API_KEY}"
      }
    }
  }
}

문제 해결

일반적인 문제와 해결 방법:

1. 명령어 없음: command 필드가 누락된 경우
2. 잘못된 경로: 지정된 파일이나 실행 파일을 찾을 수 없는 경우
3. 환경 변수 누락: 필요한 환경 변수가 설정되지 않은 경우
4. 종속성 누락: 필요한 패키지가 설치되지 않은 경우