Repolode
modelcontextprotocol

modelcontextprotocol/inspector

웹, CLI, 터미널 UI 모드로 Model Context Protocol(MCP) 서버를 테스트하고 디버깅하는 시각적 개발자 도구이자 명령줄 도구입니다.

스타
11,119
포크
1,545
열린 이슈
26
마지막 커밋
14시간 전

어떤 프로젝트인가요?

MCP Inspector를 사용하면 개발자가 Model Context Protocol 서버에 연결해 도구, 리소스, 프롬프트 등 서버가 제공하는 항목을 살펴보고 직접 호출해 동작을 확인할 수 있습니다. 단일 패키지인 @modelcontextprotocol/inspector로 제공되며, 웹 UI(기본값), 스크립트로 제어할 수 있는 CLI, 대화형 터미널 UI를 갖춘 mcp-inspector 바이너리 하나를 제공합니다.

웹 UI는 Mantine으로 구축한 Vite 및 React 단일 페이지 앱이며, Node 백엔드가 포함되어 있습니다. CLI는 자동화와 CI를 위해 설계되어 연결, 목록 조회, 호출, 결과 검증을 통해 서버의 기본 동작을 테스트할 수 있고, JSON 출력을 jq 같은 도구와 함께 사용할 수 있습니다. TUI는 Ink를 사용해 대화형 터미널 환경을 제공합니다.

패키지에는 실험적 기능인 mcpdo 바이너리도 포함됩니다. 이 연결 CLI는 지정된 서버에 한 번 연결한 뒤 로컬 데몬을 통해 여러 명령을 실행합니다. OAuth 토큰과 stdio 환경 변수 같은 비밀 정보는 지원되는 경우 OS 키체인에 저장되며, 사용할 수 없으면 파일 기반 저장 방식으로 대체됩니다.

핵심 기능

  • 01MCP 서버의 도구, 리소스, 프롬프트를 살펴보고 호출할 수 있는 웹 UI
  • 02JSON 출력을 지원하는 자동화, CI, 기본 동작 테스트용 스크립트 가능 CLI
  • 03Ink로 구축한 대화형 터미널 UI
  • 04지원되는 경우 OAuth 토큰과 비밀 정보를 OS 키체인에 저장
  • 05여러 명령에서 하나의 연결을 재사용하는 실험적 mcpdo 연결 CLI

활용 사례

  • AI 클라이언트에 연결하기 전에 개발 중인 커스텀 MCP 서버 디버깅
  • CI에서 MCP 서버를 대상으로 연결, 목록 조회, 호출, 결과 검증 테스트 실행
  • OAuth로 보호되는 MCP 서버를 대화형 또는 비대화형으로 테스트
  • 익숙하지 않은 MCP 서버에서 사용할 수 있는 도구와 각 도구의 입력 살펴보기

빠른 시작

  1. 1

    설치 없이 npx로 웹 UI를 실행하세요

    npx @modelcontextprotocol/inspector
  2. 2

    또는 대신 명령줄 클라이언트를 실행하세요

    npx @modelcontextprotocol/inspector --cli

사용 전 알아둘 점

  • 라이선스는 NOASSERTION으로 보고되며, README에는 MIT와 Apache-2.0이 혼합된 라이선스 전환에 대한 설명이 있습니다. 재사용하기 전에 LICENSE를 확인하세요.
  • OS 키체인이 없는 머신에서는 키를 제공하지 않는 한 OAuth 토큰과 같은 비밀 정보가 암호화되지 않은 채 ~/.mcp-inspector/secrets.json에 저장됩니다.
  • 개발하려면 Node 22.19.0 이상이 필요합니다.

토픽

자주 묻는 질문

inspector은(는) 무엇인가요?
웹, CLI, 터미널 UI 모드로 Model Context Protocol(MCP) 서버를 테스트하고 디버깅하는 시각적 개발자 도구이자 명령줄 도구입니다. MCP Inspector를 사용하면 개발자가 Model Context Protocol 서버에 연결해 도구, 리소스, 프롬프트 등 서버가 제공하는 항목을 살펴보고 직접 호출해 동작을 확인할 수 있습니다. 단일 패키지인 @modelcontextprotocol/inspector로 제공되며, 웹 UI(기본값), 스크립트로 제어할 수 있는 CLI, 대화형 터미널 UI를 갖춘 mcp-inspector 바이너리 하나를 제공합니다.
inspector은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
inspector은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
inspector은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. inspector의 마지막 커밋은 2026년 10월 21일입니다.
inspector은(는) 어디에 사용할 수 있나요?
AI 클라이언트에 연결하기 전에 개발 중인 커스텀 MCP 서버 디버깅 CI에서 MCP 서버를 대상으로 연결, 목록 조회, 호출, 결과 검증 테스트 실행 OAuth로 보호되는 MCP 서버를 대화형 또는 비대화형으로 테스트 익숙하지 않은 MCP 서버에서 사용할 수 있는 도구와 각 도구의 입력 살펴보기
inspector는 어떻게 설치하나요?
설치 없이 npx로 웹 UI를 실행하세요: npx @modelcontextprotocol/inspector 또는 대신 명령줄 클라이언트를 실행하세요: npx @modelcontextprotocol/inspector --cli
inspector은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/modelcontextprotocol/inspector

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트