MCP 인스펙터

MCP 인스펙터(MCP Inspector) 는 MCP 서버를 테스트하고 디버깅하기 위한 대화형 개발자 도구입니다. 디버깅 가이드에서 전체 디버깅 툴킷의 일부로 인스펙터를 다루지만, 이 문서에서는 인스펙터의 기능과 활용 방법을 더 자세히 설명합니다.

시작하기

설치 및 기본 사용법

인스펙터는 별도 설치 없이 npx로 바로 실행할 수 있습니다:

npx @modelcontextprotocol/inspector <command>

npx @modelcontextprotocol/inspector <command> <arg1> <arg2>

NPM 또는 PyPI 서버 검사

가장 흔한 방식은 NPM 또는 PyPI에서 서버 패키지를 실행해 인스펙터로 붙이는 것입니다.

  npx -y @modelcontextprotocol/inspector npx <package-name> <args>
  # For example
  npx -y @modelcontextprotocol/inspector npx server-postgres postgres://127.0.0.1/testdb

  npx @modelcontextprotocol/inspector uvx <package-name> <args>
  # For example
  npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git

로컬에서 개발한 서버 검사

로컬에서 개발했거나 저장소로 내려받은 서버를 검사할 때는 보통 아래 방식이 가장 많이 사용됩니다:

  npx @modelcontextprotocol/inspector node path/to/server/index.js args...

  npx @modelcontextprotocol/inspector \
    uv \
    --directory path/to/server \
    run \
    package-name \
    args...

정확한 실행 방법은 해당 서버 저장소/패키지에 포함된 README를 반드시 확인하세요.

기능 개요

인스펙터는 MCP 서버와 상호작용하기 위한 다양한 기능을 제공합니다:

서버 연결 패널

• 서버에 연결할 때 사용할 전송(transport)을 선택할 수 있습니다.
• 로컬 서버의 경우, 커맨드라인 인자와 환경 변수를 커스터마이징할 수 있습니다.

리소스(Resources) 탭

• 사용 가능한 모든 리소스를 나열합니다.
• 리소스 메타데이터(MIME 타입, 설명)를 표시합니다.
• 리소스 콘텐츠를 검사할 수 있습니다.
• 구독(subscription) 동작을 테스트할 수 있습니다.

프롬프트(Prompts) 탭

• 사용 가능한 프롬프트 템플릿을 표시합니다.
• 프롬프트 인자와 설명을 보여줍니다.
• 사용자 정의 인자로 프롬프트를 테스트할 수 있습니다.
• 생성되는 메시지를 미리 볼 수 있습니다.

도구(Tools) 탭

• 사용 가능한 도구 목록을 표시합니다.
• 도구 스키마와 설명을 보여줍니다.
• 사용자 정의 입력으로 도구를 테스트할 수 있습니다.
• 도구 실행 결과를 표시합니다.

알림(Notifications) 패널

• 서버에서 기록된 모든 로그를 표시합니다.
• 서버에서 수신한 알림을 보여줍니다.

모범 사례

개발 워크플로

1. 개발 시작

   • 서버와 함께 인스펙터 실행
   • 기본 연결성 확인
   • 기능(capability) 협상 확인

2. 반복 테스트

   • 서버 변경 사항 적용
   • 서버 재빌드
   • 인스펙터 재연결
   • 영향 받은 기능 테스트
   • 메시지 모니터링

3. 엣지 케이스 테스트

   • 잘못된 입력
   • 누락된 프롬프트 인자
   • 동시 작업
   • 오류 처리 및 오류 응답 검증

다음 단계