Model Context Protocol (MCP)를 위한 Wireshark: Reticle

Model Context Protocol (MCP)를 위한 Wireshark

에이전트가 보는 것을 확인하세요.

Reticle은 MCP JSON-RPC 트래픽을 실시간으로 가로채고, 시각화하며, 프로파일링(profiling)합니다. 마이크로초(microsecond) 단위의 오버헤드를 목표로 설계되었습니다.

빠른 시작 · 설치 · 문서 · 보안 · 기여하기

Reticle은 MCP 통합 디버깅을 위한 프록시(proxy) + UI입니다:

• 가공되지 않은 JSON-RPC 메시지(요청(requests) / 알림(notifications) / 응답(responses)) 검사
• 요청(request) ↔ 응답(response) 즉시 상관관계 분석
• 지연 시간(latency) 및 토큰 추정치 프로파일링
• 서버의 표준 에러(stderr) 및 충돌(crashes) 캡처
• 세션 기록 및 로그 내보내기

지원되는 전송 방식(transports): stdio, Streamable HTTP, WebSocket, HTTP/SSE.

# npm
npm install -g mcp-reticle
# pip
...

기존 MCP 서버 명령어를 mcp-reticle run --name <name> -- <command...>로 교체하세요.

.

예시 (Claude Desktop 스타일 설정):

{
"mcpServers": {
"filesystem": {
...

mcp-reticle ui

mcp-reticle run --log -- npx -y @modelcontextprotocol/server-memory

mcp-reticle proxy --name api --upstream http://localhost:8080 --listen 3001

소스 코드로 빌드하는 것을 선호한다면:

git clone https://github.com/labterminal/mcp-reticle.git
cd mcp-reticle
just build

모든 가이드와 심층 분석 내용은 GitHub Wiki에 있습니다:

• 시작하기 (Getting started)
• CLI 레퍼런스 (CLI reference)
• 클라이언트 설정 (Client configuration)
• 문제 해결 (Troubleshooting)
• 아키텍처 (Architecture)
• 보안 및 개인정보 보호 (Security & privacy)
• 개발 (Development)
• 내보내기 (Exports)

명령어	용도
mcp-reticle run	stdio MCP 서버를 래핑(wrap)하고 트래픽 검사
mcp-reticle proxy	HTTP/SSE/WebSocket 전송 방식의 역방향 프록시(Reverse proxy)
mcp-reticle ui	데스크톱 UI 실행
mcp-reticle daemon	헤드리스(Headless) 텔레메트리 허브

상세 내용: CLI 레퍼런스

Reticle은 도구(tool)의 입출력 및 서버의 표준 에러(stderr)를 캡처할 수 있습니다. 기록물과 내보낸 파일은 민감한(sensitive) 결과물로 취급하십시오.

권장 읽기 자료: 보안 및 개인정보 보호

• 저장소 가이드라인:
  CONTRIBUTING.md

• 개발 설정 및 명령어: 개발 가이드

MIT — LICENSE 참조