MCP Inspector

MCP 서버 테스트 및 디버깅을 위한 MCP 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 서버와 상호작용하기 위한 다음 기능을 제공합니다.

서버 연결 패널

• 서버에 연결할 전송(transport) 방식을 선택합니다.
• 로컬 서버의 경우 명령줄 인수와 환경을 사용자 정의할 수 있습니다.

리소스(Resources) 탭

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

프롬프트(Prompts) 탭

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

도구(Tools) 탭

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

알림(Notifications) 패널

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

모범 사례

개발 워크플로

1. 개발 시작 * 서버와 함께 Inspector를 실행합니다. * 기본 연결을 확인합니다. * 기능 협상(capability negotiation)을 확인합니다.

2. 반복 테스트 * 서버를 수정합니다. * 서버를 다시 빌드합니다. * Inspector를 재연결합니다. * 영향받은 기능을 테스트합니다. * 메시지를 모니터링합니다.

3. 엣지 케이스 테스트 * 잘못된 입력 * 누락된 프롬프트 인수 * 동시 작업 * 오류 처리 및 오류 응답 확인

다음 단계

• Inspector 레포지터리 — MCP Inspector 소스 코드를 확인합니다.
• 디버깅 가이드 — 더 넓은 디버깅 전략을 학습합니다.

원문(영어): https://modelcontextprotocol.io/docs/tools/inspector · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Model Context Protocol)에게 있습니다.

원문(영어): https://modelcontextprotocol.io/docs/tools/inspector