MCP Inspector

원문: https://modelcontextprotocol.io/docs/tools/inspector

MCP Inspector는 MCP 서버를 테스트하고 디버깅하기 위한 인터랙티브 개발자 도구입니다. 디버깅 가이드에서도 Inspector를 다루지만, 이 문서는 Inspector의 기능과 사용법을 더 자세히 설명합니다.

시작하기

설치 및 기본 사용

Inspector는 설치 없이 npx로 바로 실행됩니다.

npx @modelcontextprotocol/inspector <command>

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

npm / PyPI 패키지 검사

npm 또는 PyPI의 서버 패키지를 실행해 검사할 수 있습니다.

npm 패키지

npx -y @modelcontextprotocol/inspector npx <package-name> <args>
# 예시
npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem /Users/username/Desktop

PyPI 패키지

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

로컬 개발 서버 검사

로컬에서 개발 중이거나 저장소로 내려받은 서버는 아래 방식이 일반적입니다.

TypeScript

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

Python

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

정확한 실행 방법은 해당 서버의 README를 반드시 확인하세요.

기능 개요

Inspector는 MCP 서버와 상호작용하기 위한 다음 기능을 제공합니다.

Server connection pane

• 서버에 연결할 전송(transport) 선택
• 로컬 서버의 경우 CLI 인자와 환경 변수 커스터마이즈 지원

Resources 탭

• 사용 가능한 리소스 목록
• MIME 타입, 설명 등 메타데이터 표시
• 리소스 내용 확인
• 구독(subscription) 테스트 지원

Prompts 탭

• 프롬프트 템플릿 표시
• 프롬프트 인자 및 설명 확인
• 커스텀 인자로 프롬프트 테스트
• 생성된 메시지 미리보기

Tools 탭

• 도구 목록과 스키마/설명 표시
• 커스텀 입력으로 도구 테스트
• 도구 실행 결과 확인

Notifications pane

• 서버에서 기록된 모든 로그 표시
• 서버에서 수신한 알림 표시

베스트 프랙티스

개발 워크플로

1. 개발 시작
   • Inspector를 서버와 함께 실행
   • 기본 연결 확인
   • 기능 협상(capability negotiation) 점검
2. 반복 테스트
   • 서버 변경
   • 서버 재빌드
   • Inspector 재연결
   • 변경된 기능 테스트
   • 메시지 모니터링
3. 엣지 케이스 테스트
   • 잘못된 입력
   • 누락된 프롬프트 인자
   • 동시성 처리
   • 오류 처리/응답 검증

다음 단계