MCPJam Inspector 소개
MCPJam Inspector는 Model Context Protocol(MCP) 서버 개발자들을 위한 시각적 디버깅 툴로, 웹 UI 기반으로 서버 테스트, 툴 호출, 로깅, AI 도구 연동 등을 지원합니다. 이 도구는 modelcontextprotocol/inspector 프로젝트의 포크 버전이며, MCPJam 팀이 “더 빠르게, 더 많은 기능을” 목표로 기능을 확장해왔습니다.
MCP 개발자라면 HTTP 클라이언트로 요청 하나씩 보내며 디버깅하는 과정을 겪어봤을 것입니다. MCPJam Inspector를 쓰면 클릭 몇 번으로 테스트 서버 띄우고, 툴 호출 테스트, 로그 확인, 심지어 LLM과 상호작용해 AI 도구 테스트까지 한 곳에서 가능해집니다. 특히 AI 파라미터 완성과 LLM 모델과의 직접 연동 기능은 차별점입니다 .
MCPJam Inspector의 주요 기능
- 다양한 통신 방식 지원: STDIO, SSE, Streamable HTTP 등 거의 모든 MCP 서버 환경에서 연결 가능
- Tool 실행 및 로깅 강화: 입력 파라미터를 실시간으로 입력하고 호출 후 응답을 실시간 로그로 확인
- LLM 도구 테스트: 실제 LLM(예: Claude 등)과 연결해 MCP 툴 상호작용 테스트 가능
- 요청 저장 & 서버 관리: 요청 콜렉션, 다중 서버 연결, 저장된 연결 설정 기능 포함
- QOL 개선: AI 기반 파라미터 자동완성, 다크모드 스타일 개선, INFO 로그 색상 조정 등
설치 & 실행 가이드
CLI 기반 방식 (권장)
npx @mcpjam/inspector@latest
기본적으로 http://localhost:6274
에서 웹 UI가 자동으로 실행됩니다 .
Docker를 사용한 실행 방식
# Docker Image를 가져옵니다
docker pull mcpjam/mcp-inspector:main
# 가져온 Docker Image로 Container를 실행합니다
docker run --rm -p 6274:6274 -p 6277:6277 mcpjam/mcp-inspector:main
웹 UI는 http://127.0.0.1:6274
에서 접근 가능합니다 .
서버 연결 예시
-
기본 사용:
npx @mcpjam/inspector node build/index.js
-
커맨드라인 인자 포함:
npx @mcpjam/inspector node server.js --port 3000 --debug
-
설정 파일로 다중 서버 연결:
npx @mcpjam/inspector --config ./my-config.json
- 아래는 설정 파일 예시입니다:
{ "mcpServers": { "my-server": { "command": "node", "args": ["build/index.js"], "env": { "KEY": "value" } }, "py-server": { "command": "python", "args": ["-m", "my_mcp_server"], "env": { "PYTHONPATH": "./src" } } } } ```
- 아래는 설정 파일 예시입니다:
라이선스
MCPJam의 Inspector는 Apache License 2.0으로 배포되며, 상업적/비상업적 사용 모두 자유로운 오픈소스입니다
MCPJam Inspector 홈페이지
MCPJam Inspector 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~