자료실
개발도구MCP 서버official

MCP Inspector

MCP 서버를 시각적으로 테스트하고 디버깅하는 공식 개발자 도구

2026년 7월 22일

연결

설치

npx @modelcontextprotocol/inspector

동작 방식

AI 클라이언트 → MCP Inspector 서버 → MCP Inspector 서비스AI 클라이언트Claude Desktop · Claude CodestdioMCP Inspector 서버내 PC에서 실행MCP Inspector 서비스실제 데이터·기능

AI 클라이언트가 내 PC에서 MCP Inspector 서버를 실행해 stdio로 주고받습니다. 서버가 대신 외부 서비스를 호출하므로, 자격증명은 내 PC 설정에만 저장됩니다.

MCP Inspector는 MCP 서버를 테스트하고 디버깅하기 위한 개발자 도구입니다. 대화형 인터페이스를 제공하는 React 기반 웹 UI(MCPI)와, 그 UI를 여러 전송 방식으로 MCP 서버에 연결하는 Node.js 프로토콜 브리지(MCPP) 두 부분으로 구성됩니다. 주요 기능 · UI 모드: 브라우저에서 폼 형태로 파라미터를 입력하고 응답을 실시간으로 확인하며, 리소스는 계층 탐색과 JSON 시각화로 살펴봅니다 · CLI 모드: 명령줄에서 서버와 상호작용해 스크립팅과 자동화, 코딩 어시스턴트 연동에 활용합니다 · 서버 설정 내보내기: 단일 서버 항목이나 mcp.json 전체를 복사해 Cursor, Claude Code 같은 클라이언트에 그대로 사용합니다 · 보안 설정: 기본적으로 세션 토큰 인증을 적용하고 프록시와 클라이언트를 localhost에만 바인딩하며 Origin 헤더 검증으로 DNS 리바인딩을 방어합니다 준비물은 Node.js ^22.7.5이며 `npx @modelcontextprotocol/inspector`로 실행하면 UI가 localhost:6274에서 열립니다. 빌드된 서버를 검사하려면 뒤에 실행 명령을 붙이고, `-e key=value` 형태로 환경변수를 전달하거나 `--cli` 플래그로 CLI 모드를 사용합니다. Docker 이미지도 제공되며 라이선스는 MIT입니다. 인증을 비활성화하면 공개 인터넷뿐 아니라 브라우저를 통한 공격에도 노출된다는 경고가 문서에 명시돼 있습니다. 직접 만든 MCP 서버가 규격대로 동작하는지 확인해야 하는 개발자에게 필요한 도구입니다.

댓글 0

아직 댓글이 없습니다. 첫 댓글을 남겨보세요.