MCPJam/inspector

Testing and evaluation platform to chat, inspect, and debug MCP servers, MCP apps, and ChatGPT apps.

MCPJam Inspector – 소개

MCPJam Inspector는 MCP servers(ChatGPT, Claude, Copilot, Cursor 등 AI 기반 어시스턴트를 구동하는 백엔드) 개발자가 통합을 테스트, 디버그 및 평가할 수 있도록 돕는 오픈 소스 플랫폼입니다. 동일한 서버를 여러 클라이언트 구성에서 실행하고, 모든 JSON-RPC 및 OAuth 교환을 검사하며, CI/CD 파이프라인에서 회귀 테스트를 자동화할 수 있습니다.

핵심 기능 (README 설명 기준)

기능	수행 가능한 작업
Playground	16가지 AI 클라이언트의 UI를 모방한 대화형 웹 UI. 모델과 대화하고, 도구 호출을 트리거하며, JSON-RPC 메시지, 위젯 렌더링 및 OAuth 흐름의 전체 타임라인을 확인할 수 있습니다.
OAuth Debugger	여러 사양 버전(2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28)에 대한 MCP OAuth 흐름의 단계별 시각화. 동적 클라이언트 등록, 사전 등록 및 클라이언트 메타데이터 문서를 확인합니다.
Server Debugging	전체 JSON-RPC 로그를 관찰하면서 도구, 리소스, 템플릿, 프롬프트 및 유도 흐름을 수동으로 호출합니다.
Skills	로컬 파일 시스템이나 호스팅된 계정에서 재사용 가능한 '스킬'(동작 확장)을 로드하고, 코드를 클라우드로 전송하지 않고도 Playground에서 사용합니다.
Workspaces	서버를 공유 워크스페이스로 그룹화하고 실시간으로 동기화하여 팀 전체가 동일한 구성을 함께 테스트할 수 있습니다.
Evals	예상되는 도구 호출을 지정하는 테스트 케이스를 정의하고, 여러 LLM에서 실행하여 정확도, 지연 시간 및 도구 호출 지표를 시간에 따라 수집합니다.
CLI	브라우저 없이 서버를 조사하고, OAuth 검사를 실행하며, 도구/리소스를 나열하고, 평가를 실행하는 터미널 인터페이스 (`npx @mcpjam/inspector`).
SDK	검사 스크립트 작성, 서버 기능 스냅샷 생성, 자체 테스트 스위트에서 도구/리소스 형태에 대한 어설션을 수행할 수 있는 TypeScript 라이브러리.
CI/CD integration	모든 Pull Request마다 적합성, 엔드투엔드, 평가 및 OAuth 검사를 실행하기 위한 즉시 사용 가능한 GitHub Actions(및 일반 CI) 단계.

시작하기

방법	명령어 / 링크	참고
호스팅된 웹 앱	https://app.mcpjam.com	설치 불필요; 모든 브라우저에서 작동(HTTPS 전용).
데스크톱 앱	릴리스 페이지에서 다운로드(macOS `.dmg` 또는 Windows `.exe`).	HTTP/S 및 로컬 STDIO 서버 지원; Node.js 불필요.
터미널 (Node)	`npx @mcpjam/inspector@latest`	로컬 서버를 시작하고 브라우저에서 열 수 있는 개인 URL을 출력합니다.
Docker	소스에서 빌드 (`docker build …`) 후 `-p 127.0.0.1:6274:6274`로 실행.	보안을 위해 인스펙터를 localhost로 제한합니다.

일반적인 사용 사례

클라이언트별 오류 디버깅 – 도구 호출이 ChatGPT에서는 작동하지만 Claude에서는 실패하는 이유를 확인합니다.
OAuth 통합 테스트 – 서버가 모든 MCP OAuth 초안 버전을 준수하는지 검증합니다.
회귀 테스트 – CI에서 자동화된 평가 스위트를 실행하여 릴리스 전 정확도나 지연 시간 저하를 포착합니다.
팀 협업 – 워크스페이스 링크를 공유하여 모든 엔지니어가 동일한 서버 상태와 테스트 결과를 확인합니다.
스킬 개발 – 호스팅된 계정에 게시하기 전에 재사용 가능한 동작을 로컬에서 프로토타입으로 만듭니다.

커뮤니티 및 지원

문서: https://docs.mcpjam.com
Discord: https://discord.gg/JEnDtz8X6z
라이선스: Apache 2.0 (저장소의 LICENSE 파일 기준).

결론: MCPJam Inspector는 여러 프론트엔드 클라이언트에서 안정적으로 작동해야 하는 AI 어시스턴트 백엔드를 구축하는 개발자를 위한 풀스택 테스트 및 평가 제품군입니다. 풍부한 UI와 프로그래밍 가능한 인터페이스를 제공하여 디버깅, 성능 추적 및 CI 통합을 간편하게 만듭니다.