Detrix MCP 서버, AI 코딩 에이전트에 런타임 디버깅 기능 추가

Detrix의 기능

Detrix는 MCP(Model Context Protocol) 서버로, DAP(Debug Adapter Protocol)를 통해 AI 코딩 에이전트를 애플리케이션 디버거에 연결합니다. 실행을 중지하지 않고 로그포인트(중단 없이 값을 캡처하는 브레이크포인트)를 사용하여 실행 중인 코드를 관찰할 수 있게 합니다.

주요 기능

• 줄 번호 지정 없이 모든 줄의 변수 관찰 가능 (find_variable)
• 스택 트레이스, 메모리 스냅샷 캡처 및 표현식 평가
• 핫 경로에서 캡처 스로틀링, 샘플링 또는 속도 제한
• 관찰 내용 자동 만료 - 프로덕션 환경으로 유출되지 않음
• 기본적으로 로컬 실행 - 클라우드 의존성 없음, 데이터가 머신을 떠나지 않음
• Docker/클라우드에서 작동 - 에이전트가 데몬이 있는 곳에 연결, VPN 불필요

사용 예시

소스 예시에서, Docker의 Go 마이크로서비스가 급격히 부풀려진 수익을 보고하고 있었습니다. 에이전트는 Detrix를 사용하여:

1. 소스 코드를 읽고 사용되지 않는 단위 변환 코드 발견
2. Detrix를 통해 서비스 활성화
3. 실행 중인 컨테이너에서 txn.Amount, txn.Unit, total 변수 관찰
4. txn.Amount = 8957과 txn.Unit = "cents"가 $89.57로 변환되지 않고 달러로 합산되고 있음을 식별
5. 클라이언트 코드 수정 및 API 계약 변경 사항 상류 보고

설정

Claude Code의 경우:

brew install flashus/tap/detrix && detrix init && claude mcp add --scope user detrix -- detrix mcp

다른 MCP 호환 에이전트의 경우, .mcp.json에 추가:

{
  "mcpServers": {
    "detrix": {
      "command": "detrix",
      "args": ["mcp"]
    }
  }
}

앱에 한 줄 추가:

import detrix
detrix.init(name="my-app") # 에이전트가 필요할 때까지 대기

Claude Code 스킬

Claude의 기본 디버깅 동작을 변경하는 Claude Code 스킬이 있습니다. 설치되면, Claude는 print 문을 제안하기 전에 Detrix를 먼저 사용합니다. 또한 enable_from_diff 기능이 있습니다: 누군가 이미 추가한 print 문이 있는 git diff를 가리키면 자동으로 관찰 내용으로 변환합니다.

스킬 설치:

mkdir -p ~/.claude/skills/detrix && cp skills/detrix/* ~/.claude/skills/detrix/

GitHub: https://github.com/flashus/detrix