자율 AI 에이전트를 로컬 프로토타입에서 프로덕션 CI/CD 파이프라인으로 옮길 때, 세 가지 핵심 엔지니어링 실패 모드가 지속적으로 나타납니다:
- 검증되지 않은 MCP 도구 실행: Model Context Protocol (MCP) 서버와 에이전트 도구는 종종 검증되지 않은 셸 실행(shell execution), SSRF, 경로 탐색(path traversal), 또는 프롬프트 주입된 도구 설명(OWASP LLM01–LLM10)을 노출합니다.
- 멀티모달 궤적 오염 (
HTTP 400 INVALID_ARGUMENT): 비밀번호로 보호되는 단일 PDF, 0바이트 첨부 파일 또는 HTML 로그인 오류 페이지를 .pdf/.png 확장자로 저장하는 것만으로도 Claude Code, Google Antigravity, Codex의 장시간 실행되는 transcript.jsonl 세션을 영구적으로 손상시킵니다.
- 단일 공급자 속도 제한 및 스트림 드롭: 단일 업스트림 LLM 엔드포인트에 의존하는 것은
HTTP 429 할당량 고갈 또는 HTTP 529 업스트림 과부하 발생 시 연쇄적인 실패를 초래합니다.
오늘 저는 세 가지 제로-디펜던시 Python 엔진의 v2.0.0 버전을 오픈소스화합니다. 각 엔진은 공식 GitHub Marketplace Action으로 게시되었으며, 아무것도 설치할 필요 없이 즉시 테스트해 볼 수 있는 **대화형 브라우저 샌드박스(Interactive Browser Sandbox)**와 함께 제공됩니다.
1. MCP 및 AI 에이전트 보안 감사기 (v2.0.0)
GitHub Repository • GitHub Marketplace Action • Live Browser AST Sandbox
mcp-agent-security-auditor는 Model Context Protocol (MCP) 서버, LangChain/CrewAI 도구 및 자율 에이전트 스킬을 위해 특별히 설계된 제로-디펜던시 Python AST(Abstract Syntax Tree) 오염 및 정적 보안 분석기입니다.
주요 기능
- OWASP LLM Top 10 및 CWE에 매핑된 12가지 보안 규칙: 명령어 주입(
subprocess(..., shell=True), os.system, eval), 도구 핸들러 내 SSRF, 자격 증명 및 os.environ 유출, 임의 파일 쓰기, 그리고 도구 docstring 내부의 숨겨진 프롬프트 주입 지침을 감지합니다 (MCP-001부터 MCP-012까지).
- 네이티브 SARIF v2.1.0 출력: GitHub Security Code Scanning 탭과 직접 통합됩니다.
Drop-in GitHub Action 사용법
name: MCP & Agent Security Audit
on: [push, pull_request]
...
2. AGY 및 Claude 코드 충돌 방지 키트 (Crash Guard Kit) (v2.0.0)
GitHub Repository • GitHub Marketplace Action • 실시간 멀티모달 방화벽 샌드박스
다운로드한 PDF나 이미지를 읽은 후, 200단계에 달하는 에이전트 대화가 HTTP 400 INVALID_ARGUMENT 오류로 영구적으로 중단된 경험이 있다면, 근본 원인은 거의 항상 멀티모달 궤적 오염(multimodal trajectory poisoning) 때문입니다. 암호화된 PDF(/Encrypt), 0바이트 파일 또는 PNG/PDF로 위장된 HTML 오류 페이지가 transcript.jsonl에 추가되면, 이후의 모든 API 호출이 실패합니다.
주요 기능
- 사전 비트(Pre-Flight) 바이너리 및 매직 바이트 방화벽: 외부 종속성 없이 매직 바이트(
%PDF-, PNG/JPEG/WebP 헤더)를 검사하고, PDF /Encrypt 딕셔너리를 감지하며, read_file이 호출되기 전에 크기가 너무 크거나 가짜 HTML 미디어를 차단합니다.
- 자가 치유 JSONL 궤적 외과 의사: 오염된
.jsonl 기록을 스캔하고, 손상된 멀티모달 블록을 격리하며, 타임스탬프가 찍힌 백업본을 생성한 후, 세션을 제자리에서 수술적으로 복구합니다.
# 에이전트 입력 전에 모든 미디어 또는 PDF를 사전 검증
python crash_guard.py --check ./downloads/statement.pdf
...
3. 무한 LLM 폴백 라우터 (Infinite LLM Fallback Router) (v2.0.0)
GitHub Repository • GitHub Marketplace Action • Live Failover Simulator
infinite-llm-fallback-router는 Anthropic Claude, Google Gemini, OpenAI, DeepSeek 및 로컬 OpenAI 호환 서버 전반에 걸쳐 요청을 라우팅하는 가볍고(lightweight), 의존성 제로(zero-dependency)의 다중 공급자(multi-provider) AI 게이트웨이입니다.
주요 기능 (Key Capabilities)
- 서브초 장애 조치 및 상태 기반 회로 차단기 (Sub-Second Failover & Stateful Circuit Breakers):
HTTP 429, 500, 502, 503, 및 529 응답을 자동으로 감지하고, 지수적 냉각 시간(exponential cooldowns)이 적용된 공급자별 회로 차단기(circuit breakers)를 작동시킨 후, 공급자 간에 원활하게 장애 조치(failover)합니다.
- CI/CD 경로 매트릭스 검증 (CI/CD Route Matrix Verification): 커밋마다 라우팅 구성 및 폴백 체인(fallback chains)을 검증하는 깃허브 액션(GitHub Action)으로 제공됩니다.
4. 보너스: Vision Flow Studio Pro v2.0에 내장된 WebCrypto RFC 6238 TOTP 2FA 금고
이 세 가지 오픈소스 리포지토리와 함께, 저희는 Vision Flow Studio Pro v2.0에 **Step 08: 클라이언트 측 WebCrypto TOTP 2FA 코드 생성기(Client-Side WebCrypto TOTP 2FA Code Generator)**를 배포했으며, Vision Flow Agency에서 풀스택(full-stack) SaaS 및 사이버 보안 엔지니어링 쇼케이스를 업데이트했습니다.
세 가지 오픈소스 도구 모두 MIT 라이선스가 적용되었으며 오늘 바로 사용 가능합니다:
피드백, 이슈 및 풀 리퀘스트(pull requests)는 언제든지 환영합니다!