MCP 통신을 터미널에서 실시간으로 가로채서 모니터링하는 투명 프록시
중간맛 분석
Go로 작성된 단일 바이너리 도구입니다. stdio 서버를 래핑하거나 HTTP 서버를 리버스 프록시로 운영할 수 있으며, 모든 JSON-RPC 프레임을 실시간으로 터미널 TUI에 표시합니다. 기본 설치 후 mcpsnoop --이름 [서버 명령]으로 감싸기만 하면 자동으로 AI 클라이언트 요청을 캡처하고, 별도 플래그나 설정 없이 즉시 라이브 UI(mcpsnoop 명령)로 볼 수 있습니다. 세션 저장, 필터링, 재생, 내보내기(JSON/HTML/HAR/OTLP) 등 풍부한 기능을 갖췄습니다.
이런 레포예요
이럴 때 쓰면 좋아요
- AI 코드 어시스턴트(Cursor, Claude, Codex)가 도구를 제대로 호출하지 않거나 잘못 호출할 때 실제 요청/응답 내용을 실시간으로 디버깅
- MCP 서버 개발 중 클라이언트와 서버 간 통신에서 malformed 프레임, 스트림 오염, 프로토콜 위반을 즉각 감지
- CI/CD에서 MCP 세션의 오류, 타이밍, 도구 정의 변경을 자동 검증하고 성능 회귀를 추적
핵심 기능
대안 대비 차별점
공식 MCP Inspector와 달리 실제 AI 클라이언트 요청을 데이터 경로 중간에서 투명하게 가로채므로, 감춰진 통신 오류, 스트림 오염, 프로토콜 위반을 정확히 진단할 수 있습니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
바로 차려먹기Go
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/kerlenton/mcpsnoop.git && cd mcpsnoop && go run .
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- 설치
go install github.com/kerlenton/mcpsnoop/cmd/mcpsnoop@latest
또는 Homebrew:
brew install kerlenton/mcpsnoop/mcpsnoop
또는 Releases 페이지에서 미리 빌드된 바이너리를 다운로드하세요.
- 데모 세션 실행
mcpsnoop demo
- 실제 MCP 서버 래핑 AI 클라이언트의 MCP 설정 파일에서 server command를 다음과 같이 수정합니다:
{
"mcpServers": {
"my-server": {
"command": "mcpsnoop",
"args": ["--", "node", "build/index.js"]
}
}
- 라이브 TUI 열기 AI 클라이언트를 정상적으로 사용하고, 다른 터미널에서 다음을 실행합니다:
mcpsnoop
- (선택) HTTP 서버 프록시 Streamable-HTTP MCP 서버를 프록시하려면:
mcpsnoop http --target http://localhost:3000/mcp --listen :7000
- (선택) 세션 내보내기 캡처된 세션을 HTML, JSON, HAR, OTLP 등으로 내보냅니다:
mcpsnoop export -T html -o out.html
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try kerlenton/mcpsnoop
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「MCP·클로드 연동」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/kerlenton/mcpsnoop)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기