MCP 인스펙터

MCP 인스펙터는 MCP 서버를 테스트하고 디버깅하기 위한 기준이 되는 개발자 도구입니다. 이 도구는 단일 패키지인 @modelcontextprotocol/inspector 형태로 제공되며, 하나의 바이너리 안에 세 가지 클라이언트가 포함되어 있습니다.

클라이언트	호출 방식	용도
Web	npx @modelcontextprotocol/inspector	브라우저 내에 있는 완전한 그래픽 기반 인스펙터로, 기본값이면서 가장 다양한 기능을 제공합니다.
CLI	npx @modelcontextprotocol/inspector --cli	CI, 셸 파이프라인, 코딩 에이전트 등을 위한 스크립트화가 가능하고 기계가 읽을 수 있는 형태의 클라이언트입니다.
TUI	npx @modelcontextprotocol/inspector --tui	브라우저를 사용할 수 없거나 사용하지 않고 싶을 때 사용할 수 있는 대화형 터미널 UI입니다.

세 가지 클라이언트 모두 동일한 공유 코어를 기반으로 구축되었기 때문에 연결 방식은 모두 동일하게 동작합니다. 즉, 동일한 트랜스포트, 동일한 설정 파일, 디스크상의 동일한 OAuth 상태, 그리고 동일한 프로토콜 시대의 기능 협상 방식(레거시 방식과 2026-07-28의 현대 방식)을 적용합니다.

서버에 연결된 MCP 인스펙터 Web 클라이언트. 작업 중에도 프로토콜 트래픽을 계속 볼 수 있도록 모니터링 사이드바가 고정되어 있습니다.

빠른 시작

인스펙터를 사용하려면 Node 22.19.0 이상이 필요하며, npx을 통해 직접 실행되므로 별도의 설치가 필요하지 않습니다.

# Launch the web UI and connect to a local stdio server
npx @modelcontextprotocol/inspector node path/to/server/index.js

# Or launch with no target and add servers from the UI
npx @modelcontextprotocol/inspector

이 명령어는 일회용 세션 토큰이 포함된 URL을 출력하므로 브라우저에서 해당 URL을 열어 주십시오. Web 클라이언트를 참조하십시오.

# List a server's tools and exit
npx @modelcontextprotocol/inspector --cli node path/to/server/index.js --method tools/list

# Call a tool and pipe the result into jq
npx @modelcontextprotocol/inspector --cli https://api.example.com/mcp --transport http \
  --method tools/call --tool-name get_weather --tool-arg city=Boston --format json | jq .result

CLI 클라이언트를 참조하십시오.

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

TUI 클라이언트를 참조하십시오.

공개된 서버 검사하기

서버를 시작하는 명령어를 인스펙터의 인수로 전달하거나, --server-url을 사용하여 원격 서버를 지정할 수 있습니다.

npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem ~/Desktop

npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git

npx @modelcontextprotocol/inspector --server-url https://api.example.com/mcp --transport http

모든 서버는 각기 다른 명령어와 인수를 요구하므로 먼저 해당 서버의 README를 꼭 읽어 보시기 바랍니다.

런처 플래그와 클라이언트 플래그의 차이

mcp-inspector, 즉 npx @modelcontextprotocol/inspector에 의해 실행되는 바이너리는 단순한 런처입니다. 이 런처는 오직 두 가지 항목만을 관리합니다.

1. 모드 플래그: --web(기본값), --cli, 또는 --tui입니다. 하나만 지정할 수 있으며, 둘 이상을 전달하면 Specify at most one of --web, --cli, or --tui.과 같은 오류가 발생합니다.
2. -h / --help.

그 외의 모든 항목(--catalog, --config, --server-url, --transport, --method, OAuth 플래그 등)은 런처가 아닌 _클라이언트_에 의해 정의되며, 모든 클라이언트가 동일한 세트의 플래그를 정의하는 것은 아닙니다. 구성 및 플래그 페이지도 각 항목의 소유자별로 체계적으로 구성되어 있습니다.

모드 플래그는 명령줄의 맨 앞에서만 인식됩니다. --web / --cli / --tui가 아닌 첫 번째 토큰이 런처 파싱을 마치게 되며, 그 이후의 모든 내용은 그대로 클라이언트에 전달됩니다. 이러한 방식 덕분에 나중에 --cli와 같은 문자열도 서버 자체의 인수 중 하나로 사용될 수 있습니다.

mcp-inspector --cli node server.js --cli   # mode is CLI; the trailing --cli goes to server.js

--help는 모드 플래그의 유무에 따라 동작이 달라집니다. 모드 플래그가 없는 상태의 mcp-inspector --help는 런처의 도움말을 출력한 후 종료됩니다. 반면 모드 플래그가 있을 경우에는 그 내용이 전달되므로 mcp-inspector --cli --help은 CLI의 전체 플래그 참조 정보를 출력하게 됩니다.

다음으로 할 일

◇Web 클라이언트

그래픽 기반 인스펙터의 탭별 사용 방법에 대한 안내입니다.

→

◇CLI 클라이언트

메서드 참조, 출력 형식, 종료 코드, 그리고 CI 관련 정보입니다.

→

◇TUI 클라이언트

터미널 내 이동 방법과 키보드 사용법에 대한 안내입니다.

→

◇구성 및 플래그

카탈로그 파일과 설정 파일의 차이점, 각 클라이언트별 플래그에 대한 상세 참고 자료, 그리고 환경 변수에 대한 내용입니다.

→

◇권한 부여

OAuth 흐름의 전체 과정, 세션 중간에 이루어지는 권한 부여 재처리, 그리고 루프백 처리에 대한 내용입니다. 콜백에 대한 내용입니다.

→

◇프로토콜의 시대

구버전 방식과 최신 버전(2026-07-28) 방식의 작동 방식의 차이점, 그리고 각 시대별 설정이 어떻게 변화하는지에 대한 내용입니다. 프로토콜의 시대에 대한 내용입니다.

→

◇레시피

클라이언트 설정 파일의 가져오기 방법, MCP 앱들의 검토 방법, Docker 활용 방법, 그리고 네트워크 호스팅 방법에 대한 내용입니다.

→

◇디버깅 가이드

인스펙터를 넘어서는 보다 포괄적인 디버깅 전략에 대한 내용입니다.

→