---
title: MCP Inspector — MCP 프로토콜
date: 2026-10-18
time: 12:00
model: admin
category: programs
author_type: human
summary: stdio·SSE·Streamable HTTP 전송을 지원하는 MCP 서버 테스트·디버깅 웹 UI.
tags: 프로그램, MCP 프로토콜, inspector
---

MCP 서버를 테스트하고 디버깅하는 공식 개발자 도구

## 기본 정보

| 프로그램 이름 | MCP Inspector (MCP 인스펙터) |
| --- | --- |
| 한 줄 소개 | MCP 서버를 테스트하고 디버깅하는 공식 개발자 도구 |
| 개발·유지 | Model Context Protocol 프로젝트 |
| 공식 홈페이지 | https://modelcontextprotocol.io/docs/tools/inspector |
| 공식 문서 | https://modelcontextprotocol.io/docs/tools/inspector |
| 설치·배포 | npx @modelcontextprotocol/inspector |
| 동작 환경 | Node.js 18+ · 웹 브라우저 |
| 라이선스 | MIT 라이선스 |
| 안정 버전 | 2.11.0 (npm, 2026-10 확인) — 확인일 2026-10-18 |
| GitHub 저장소 | https://github.com/modelcontextprotocol/inspector |
| 분류 | MCP 프로토콜 (태그: MCP, 디버깅, 테스트, 프로토콜, 개발자 도구) |

## 이 프로그램은 무엇인가?

MCP Inspector는 MCP(Model Context Protocol) 서버를 테스트하고 디버깅하기 위한 공식 개발자 도구입니다. React 기반 웹 UI와 Node.js 프록시로 구성되어 있으며, 하나의 패키지(@modelcontextprotocol/inspector)에 세 가지 클라이언트를 담고 있습니다.

서버가 노출하는 도구·리소스·프롬프트를 시각적으로 확인하고, 요청·응답 메시지를 실시간으로 살펴볼 수 있습니다. MCP 서버를 만들거나 기존 서버를 연결할 때 가장 먼저 켜는 도구입니다.

## 어떤 문제를 해결하는가?

- 새로 만든 MCP 서버가 정상 동작하는지 확인해야 하는 상황
- 클라이언트에서 MCP 서버 연결이 실패할 때 원인을 찾아야 하는 상황
- stdio·HTTP 등 서로 다른 전송 방식을 동일 환경에서 비교해야 하는 상황
## 주요 기능

### 웹 UI

브라우저에서 도구·리소스·프롬프트를 시각적으로 탐색

- **활용 상황**: 서버 기능을 한눈에 파악
- **얻는 결과**: 타이핑 없이 도구 호출·결과 확인
- **제한 사항**: 대용량 응답은 스크롤이 필요할 수 있음
### 다중 전송 지원

stdio·SSE·Streamable HTTP 전송을 모두 지원

- **활용 상황**: 모든 종류의 MCP 서버 디버깅
- **얻는 결과**: 전송 방식별 동작 비교 가능
- **제한 사항**: 전송별 인증 설정이 조금씩 다름
### 실시간 모니터링

프로토콜 트래픽을 사이드바에 실시간 표시

- **활용 상황**: 요청·응답 흐름 추적
- **얻는 결과**: 디버깅용 상세 로그 확보
- **제한 사항**: 로그가 많으면 필터링 필요
### 설정 내보내기

서버 실행 구성을 mcp.json으로 내보내기

- **활용 상황**: 클라이언트 설정 공유
- **얻는 결과**: 재현 가능한 디버깅 환경 구성
- **제한 사항**: 클라이언트별 형식 차이 확인 필요
## 설치 및 실행

### npx (권장)

별도 설치 없이 npx로 즉시 실행합니다.

```
npx @modelcontextprotocol/inspector
```

### npm 글로벌 설치

자주 사용한다면 글로벌로 설치합니다.

```
npm install -g @modelcontextprotocol/inspector
```

### Docker

컨테이너로 격리 실행합니다.

```
docker run -p 5173:5173 -p 8080:8080 mcp/inspector
```

## 실제 사용 예제

### 서버 연결

Inspector를 실행하고 MCP 서버 명령을 입력해 연결합니다.

```
npx @modelcontextprotocol/inspector npx -y @modelcontextprotocol/server-filesystem /tmp
```

### 도구 호출

Tools 탭에서 도구를 선택하고 인자를 넣어 실행합니다.

```
예: read_file 도구에 경로를 넣고 Run
```

### 트래픽 검토

Monitoring 사이드바에서 요청·응답 메시지를 확인합니다.

```
STDIO · SSE · HTTP 로그 실시간 확인
```

## 장점과 한계

### 장점

- MCP 공식 프로젝트가 유지하는 신뢰도 높은 도구
- stdio·SSE·HTTP 전송을 한 UI에서 지원
- 별도 설치 없이 npx로 즉시 실행
- 요청·응답 트래픽을 시각적으로 추적
### 사용 전에 고려할 점

- 서버 측 로직 자체의 디버깅은 별도 도구 필요
- 대규모 툴 목록은 탐색이 다소 느릴 수 있음
- OAuth 인증 흐름은 추가 설정이 필요
## 비슷한 프로그램과 비교

| 프로그램 | 특징 | 이런 경우에 적합 |
| --- | --- | --- |
| curl·Postman | 직접 HTTP 요청으로 테스트 | MCP가 아닌 일반 API 테스트 |
| Claude Desktop 로그 | 호스트 앱 측 연결 로그 확인 | 클라이언트 통합 문제 추적 |
| mcp-use 디버거 | Python 프레임워크 내장 디버깅 | mcp-use 기반 프로젝트 |

## 공식 자료 및 추가 학습

- [공식 홈페이지](https://modelcontextprotocol.io/docs/tools/inspector) — https://modelcontextprotocol.io/docs/tools/inspector
- [공식 문서 / 지식베이스](https://modelcontextprotocol.io/docs/tools/inspector) — https://modelcontextprotocol.io/docs/tools/inspector
- [설치·배포](npx @modelcontextprotocol/inspector) — npx @modelcontextprotocol/inspector
- [릴리스 노트](https://github.com/modelcontextprotocol/inspector/releases) — https://github.com/modelcontextprotocol/inspector/releases
- [소스 / 개발 자료](https://github.com/modelcontextprotocol/inspector) — https://github.com/modelcontextprotocol/inspector
버전·지원 환경 정보는 2026-10-18 기준으로 공식 사이트에서 확인한 값입니다. 설치 명령은 사용하는 배포판과 버전에 따라 달라질 수 있으므로 공식 설치 문서를 함께 확인하세요.

## 실제 실행 화면

합성 예시 — 실제 실행 결과가 아닙니다. 화면은 합성 예시이며 실제 실행 결과가 아닙니다.

![MCP Inspector 실행 화면 예시](https://games.cursorai.co.kr/assets/inspector-demo.png)

실제 운영 중인 서버

---
원문(HTML): https://games.cursorai.co.kr/programs/mcp/protocol/inspector.html