Lekssays/codebadger

codebadger은(는) 무엇을 하나요?

🦡 codebadger는 컨테이너화된 Model Context Protocol (MCP) 서버로, AI 에이전트와 LLM이 Joern 코드 속성 그래프(CPG)를 통해 코드베이스의 구조와 데이터 흐름에 깊이 있게 접근하고 질의할 수 있도록 합니다.

기능

• CPG 기반 질의: 코드베이스의 추상 구문 트리(AST), 제어 흐름 그래프(CFG), 데이터 의존성 그래프(DDG) 등을 SQL과 유사한 쿼리로 탐색할 수 있습니다.
• 취약점 분석: Joern의 강력한 정적 분석 엔진을 활용하여 보안 취약점 패턴을 식별하고 보고할 수 있습니다.
• 컨테이너화된 배포: Docker 컨테이너로 실행되므로 로컬 환경에 영향을 주지 않고 즉시 사용 가능합니다.
• MCP 프로토콜 지원: Claude Code, Cursor, Codex 등 MCP를 지원하는 모든 AI 에이전트와 호환됩니다.

사용 예시

다음과 같은 질문을 AI 에이전트에게 할 수 있습니다:

• "이 프로젝트에서 특정 함수 processData를 호출하는 모든 위치를 찾아줘."
• "데이터베이스 연결이 안전하게 닫히지 않는 코드 경로를 분석해줘."
• "모듈 A와 모듈 B 사이의 모든 의존성 관계를 시각화해줘."

시작하기

필수 조건

• Docker
• MCP를 지원하는 AI 에이전트 (예: Claude Desktop, Cursor)

설치 및 실행

1. 레포지토리를 클론합니다:

git clone https://github.com/Lekssays/codebadger.git
cd codebadger

2. Docker 컨테이너를 빌드하고 실행합니다:

docker build -t codebadger .
docker run -p 8080:8080 -v /path/to/your/codebase:/workspace codebadger

3. AI 에이전트 설정에서 MCP 서버 엔드포인트를 http://localhost:8080/mcp로 지정합니다.

환경 변수

변수명	설명	기본값
MCP_PORT	MCP 서버 포트	8080
WORKSPACE_PATH	분석할 코드베이스 경로	/workspace
JOERN_OPTS	Joern 엔진 추가 옵션	(없음)

라이선스

MIT License

참고 자료

• Joern 공식 문서
• Model Context Protocol 스펙
• GitHub 저장소