웹, CLI, 터미널 UI 모드로 Model Context Protocol(MCP) 서버를 테스트하고 디버깅하는 시각적 개발자 도구이자 명령줄 도구입니다.
MCPJam/inspector
MCP 서버, MCP 앱, ChatGPT 앱을 검사하고 채팅하며 디버깅할 수 있는 오픈소스 테스트·평가 플랫폼입니다.
- 스타
- 2,274
- 포크
- 297
- 열린 이슈
- 316
- 마지막 커밋
- 2시간 전
어떤 프로젝트인가요?
MCPJam Inspector는 MCP 서버를 개발하는 사람들을 위한 테스트·평가 플랫폼입니다. 도구, 리소스, 프롬프트, elicitation 흐름을 직접 실행하고, 진행 과정에서 전체 JSON-RPC 로그와 OAuth 교환 내역을 확인할 수 있습니다. Playground에서는 서버를 대상으로 모델과 채팅할 수 있으며, OpenAI Apps SDK와 MCP 앱 UI도 지원합니다. 위젯 에뮬레이터를 사용하면 데스크톱, 태블릿, 모바일 크기별 레이아웃을 미리 볼 수 있습니다.
이 프로젝트는 평가와 회귀 테스트도 지원합니다. 예상 도구 호출이 포함된 테스트 케이스를 정의하고, 여러 LLM에서 실행해 정확도를 시간에 따라 추적할 수 있습니다. 안내형 OAuth 디버거는 동적 클라이언트 등록과 CIMD를 포함해 여러 버전의 MCP authorization spec을 기준으로 적합성을 확인합니다.
자동화를 위해 MCPJam은 CLI와 SDK를 제공하며, GitHub Actions나 다른 CI 시스템에서 각 pull request마다 적합성, E2E, 평가, OAuth 검사를 실행할 수 있습니다. 호스팅 웹 앱, Mac 및 Windows용 데스크톱 앱으로 이용하거나 npx와 Docker를 통해 실행할 수 있습니다.
핵심 기능
- 01LLM을 대상으로 도구를 테스트하는 Playground 채팅과 도구 호출 및 JSON-RPC 메시지의 전체 추적 기능.
- 02OpenAI Apps SDK 및 MCP 앱 UI를 위한 위젯 에뮬레이터와 데스크톱·태블릿·모바일 미리보기.
- 03여러 버전의 MCP authorization spec, DCR, CIMD를 다루는 안내형 OAuth 디버거.
- 04예상 도구 호출을 설정하고 여러 LLM에서 정확도를 추적하는 평가 기능.
- 05터미널이나 자체 테스트에서 서버를 점검하고 검사를 실행할 수 있는 CLI 및 SDK.
- 06모든 PR에서 적합성, E2E, 평가 검사를 실행하는 CI/CD 통합 기능.
활용 사례
- ChatGPT, Claude, Cursor에 연결하기 전에 MCP 서버의 도구와 프롬프트를 디버깅하기.
- MCP 서버의 OAuth 설정을 단계별로 확인해 인증 오류를 찾아내기.
- 도구 정의가 바뀔 때마다 여러 LLM에서 회귀 평가를 실행하기.
- GitHub Actions에서 MCP 적합성 테스트를 통과해야 pull request를 병합하도록 설정하기.
빠른 시작
- 1
브라우저에서 호스팅된 앱을 엽니다(설치 필요 없음).
- 2
또는 Node.js 20 이상에서 npx로 MCPJam을 로컬에서 실행합니다.
npx @mcpjam/inspector@latest
사용 전 알아둘 점
- 호스팅된 웹 앱은 HTTPS 서버 URL만 지원하며 STDIO 서버는 지원하지 않습니다.
- 터미널 설치에는 Node.js 20 이상이 필요합니다.
- 데스크톱 앱은 Mac과 Windows에서만 사용할 수 있습니다.
- 리포지토리 메타데이터에는 명확한 라이선스가 표시되어 있지 않지만(NOASSERTION), README에는 Apache 2.0이라고 명시되어 있습니다.
토픽
자주 묻는 질문
- inspector은(는) 무엇인가요?
- MCP 서버, MCP 앱, ChatGPT 앱을 검사하고 채팅하며 디버깅할 수 있는 오픈소스 테스트·평가 플랫폼입니다. MCPJam Inspector는 MCP 서버를 개발하는 사람들을 위한 테스트·평가 플랫폼입니다. 도구, 리소스, 프롬프트, elicitation 흐름을 직접 실행하고, 진행 과정에서 전체 JSON-RPC 로그와 OAuth 교환 내역을 확인할 수 있습니다. Playground에서는 서버를 대상으로 모델과 채팅할 수 있으며, OpenAI Apps SDK와 MCP 앱 UI도 지원합니다. 위젯 에뮬레이터를 사용하면 데스크톱, 태블릿, 모바일 크기별 레이아웃을 미리 볼 수 있습니다.
- inspector은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- inspector은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- inspector은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. inspector의 마지막 커밋은 2026년 10월 22일입니다.
- inspector은(는) 어디에 사용할 수 있나요?
- ChatGPT, Claude, Cursor에 연결하기 전에 MCP 서버의 도구와 프롬프트를 디버깅하기. MCP 서버의 OAuth 설정을 단계별로 확인해 인증 오류를 찾아내기. 도구 정의가 바뀔 때마다 여러 LLM에서 회귀 평가를 실행하기. GitHub Actions에서 MCP 적합성 테스트를 통과해야 pull request를 병합하도록 설정하기.
- inspector는 어떻게 설치하나요?
- 브라우저에서 호스팅된 앱을 엽니다(설치 필요 없음). 또는 Node.js 20 이상에서 npx로 MCPJam을 로컬에서 실행합니다.: npx @mcpjam/inspector@latest
- inspector은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/MCPJam/inspector
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
stdio, SSE, HTTP를 통해 Model Context Protocol(MCP) 서버를 테스트·디버깅·자동화하는 터미널 UI 및 CLI입니다.
Claude Desktop, Cursor, VS Code 등 주요 AI 클라이언트에 MCP 서버를 설치하고, 원격 서버의 OAuth 인증도 처리하는 CLI입니다.
MCP 서버와 React 뷰를 사용하는 MCP Apps 및 클라이언트를 만들 수 있는 TypeScript 프레임워크로, Inspector와 CLI를 기본 제공합니다.
LLM 애플리케이션 출력을 테스트하는 사전 구성 및 사용자 지정 평가기를 제공하는 Python·TypeScript 라이브러리로, LLM-as-judge 채점을 지원합니다.
스마트 컨트랙트와 dapp을 컴파일하고 배포·테스트·디버깅하기 위한 Ethereum 개발 환경입니다.