MCPJam Inspector: MCP Server의 시각적 디버깅을 위한 Web UI 기반 도구

9bow · 7월 2, 2025, 3:30오전

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로 변경도 가능합니다.)

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~