실행계획 분석, SQL 리뷰, 코드 리뷰, 기술 문서 생성까지 — Claude AI가 DBA와 Java 개발자의 작업을 돕는 React SPA 대시보드
# 1. Clone & Build $ git clone https://github.com/Sangmoo/Claude-Java-Toolkit.git $ mvn package -DskipTests # 2. Run $ java -jar claude-toolkit-ui/target/claude-toolkit-ui-*.jar # 3. Open browser → http://localhost:8027
🚀 v4.7.x 차세대 — Platform
Claude Code / Cursor / Cline 등 AI agent 가 IDE 안에서 12+ 분석 기능을 직접 호출. 도구의 정체성 변화 — 별도 페이지로 가야 사용 가능하던 도구가 사내 모든 시스템의 hub 로 진화. CI/CD / curl / 사내 자동화도 같은 X-Api-Key 헤더로 즉시.
/admin/api-keys.POST /api/v1/analyze 동기 호출 — 12개 feature 통합 진입점. 응답에 토큰 + 비용 + latency + 모델 + 캐시 적중. Live DB 통합 자동 (dbProfileId 파라미터). GET /api/v1/features discovery — SDK 자동 생성 / CLI auto-complete 활용.@claude-toolkit/mcp-server npm 패키지 — Anthropic MCP 표준 서버 (stdio transport). Claude Code / Cursor / Cline / Continue.dev 자동 호환. 12개 분석 tool 노출: SQL 분석 6 + Java/Code 분석 6. 5분 통합 — ADMIN 키 발급 → mcp_settings.json 한 줄 → IDE 재시작. 📘 docs/mcp-setup.mdv4.7.1 — 누적 패치
v4.7.0 메이저 릴리스 직후 운영팀 / 외부감사인 / 일반 사용자가 현장에서 바로 체감할 수 있는 5가지 영역 동시 강화. 모두 기존 컴포넌트 재사용 위주로 백엔드 구조 변경 최소화.
*** 평문 보관 X). 신규 페이지 /admin/config-changes.review vs security 옵션 충돌 버그 회귀 방지. JVM 라이프타임 hit/miss 카운터 + 적중률, 모든 결과 헤더에 ⚡ 캐시 적중 칩 (Claude API 비용 0).성능, SLA위반, DB) — 본인 또는 ADMIN 만 수정. 헤더 dropdown 빈도순 빠른 선택 + 클릭으로 토글 필터. 카드 행 칩 + 확장 영역 자동완성 dropdown (Enter 저장 / Esc 취소). 정규화: trim / 빈·중복 제거 / 30자 상한, ,DB, 패턴으로 콤마 매칭 충돌 방지./chat/send + /chat/stream SSE 인프라 그대로 재사용 (백엔드 변경 0). 결과 + 원본 입력 + 페이지 라벨을 첫 질문 시 1회 컨텍스트로 전달, 이후 멀티턴. 22+ 분석 페이지에 한 번에 적용.sql_review → /explain → /sql/index-advisor → /sql-translate → /erd 등 자연스러운 흐름. sessionStorage 기반 1회용 handoff (60초 TTL), URL 길이 제한·로그 노출 우려 0. sameInput / extractFirstCodeBlock 변환 정책으로 다음 페이지 입력 자동 채움. 자동 채워진 페이지에는 🔗 체이닝 입력 인디케이터.SqlClassifier + ReadOnlyJdbcTemplate + kill switch. Default OFF. 6개 SQL 페이지 자동 적용. Oracle + PostgreSQL 11+. (Phase 4) 인덱스 시뮬레이터: INVISIBLE INDEX 트릭으로 추천 인덱스 비용 비교 — 운영 영향 0. (Phase 5) 운영 대시보드: Rate limiter (분당 사용자별 quota, sliding window) + 회로차단기 (10분 내 timeout 5건 → 5분 자동 비활성) + 호출 통계 (프로필별 성공/실패/timeout/avg latency) + /admin/health 카드 + ADMIN 강제 복구 / 통계 reset 엔드포인트.v4.7.0 — 메이저 릴리스
운영팀 / 외부감사인 / 사용자 모두를 위한 5개 영역 동시 강화. 한국 컴플라이언스 4종 자동 리포트와 영구 이력 저장이 추가되며, 사용자별 인사이트와 시스템 헬스 모니터링까지 포함된 메이저 업데이트입니다.
/roi-report 페이지에 두 신규 섹션. 내 활동 — 본인 분석/채팅/시간 절감 + Top 5 기능 BarChart + 12주 누적 추이 LineChart. 팀 비교 (ADMIN) — 팀 평균/누적 + 본인 순위·백분위 진행 바 + Top 5 사용자./api/v1/search 에 type / from / to / sort 4개 파라미터. 매치 위치 ±60자 발췌 snippet + <mark> 노란 강조. SearchPage 에 필터 토글 + URL 동기화 (공유·새로고침 안전). title/type/input/output 매치 필드 라벨 칩 표시.🪙 ~12K 토큰 · 예상 $0.062 (Sonnet 4). 한국어 1.8 chars/token + 영어 3.5 chars/token 휴리스틱(±15% 오차). 큰 입력으로 무심코 비용 발생하는 사고 방지. 23개 분석 페이지 자동 적용 (AnalysisPageTemplate 단일 변경).mvn test 한 번이면 백엔드 전반 검증.v4.6.1 — 이전 업데이트
큰 신규 기능보다는 사용자가 매일 마주치는 마찰을 한 번에 정리하는 데 집중한 패치입니다. 검색·이력·정확도 세 축에서 즉시 체감되는 개선이 모여 있습니다.
/api/v1/search 가 존재하지 않는 필드(menuName / inputText) 를 참조해 항상 빈 결과를 반환하던 결정적 버그를 수정 — 이제 메뉴 카탈로그와 분석 이력이 한 화면에 정확히 매칭됩니다./analyze 경로만 review_history 에 저장되고 SSE 스트리밍 경로는 누락되어 있어, 실제 사용 경로의 결과가 이력·검색에 잡히지 않던 버그를 수정. 테이블 영향 분석 / SP→Java 하네스 / SQL 최적화 하네스 / 오류 로그 RCA 하네스 4종 모두 스트리밍 완료 시점에 저장되도록 통일했습니다.insertOrder 등) 을 가진 매퍼가 여러 개 있을 때, 단순 .shortId( 매칭으로 모든 매퍼의 호출자로 잘못 기록되어 테이블 영향 분석에서 무관한 Java/Controller 가 부풀려져 보이던 버그를 수정. mapper 클래스명이 그 파일에 단어 경계로 존재하는지까지 검증하는 디스앰비귀에이션 로직을 추가했습니다./impact 페이지를 TABLE → MyBatis → Java → Controller 4단계 역추적으로 단순화하고, MyBatis 구문 / Java 파일 / Controller 행을 클릭하면 모달로 전체 소스가 열리며 전체 복사 버튼으로 클립보드에 즉시 복사할 수 있습니다. DB 테이블 픽커도 함께 추가.useHarnessStream 이 매 SSE 메시지마다 '\n' 을 인위적으로 덧붙이고 있어 Claude 가 단어 중간에서 청크를 끊으면 "활\n용" 이 마크다운 soft-break 로 단어가 갈라져 보이던 버그를 수정. flush 기준을 줄바꿈 단위 → STAGE_MARKER prefix 보호로 변경./package-deps) 와 SP 흐름 분석(/sp-impact) 두 메뉴를 백엔드 엔드포인트 + 프론트 라우트 + e2e 회귀 테스트까지 완전히 제거했습니다. 잔존 참조 0건. 패키지 분석은 /package-overview 의 4탭(요약/ERD/풀흐름도/스토리) 으로, SP 추적은 데이터 흐름 분석에서 SP 시작점으로 처리됩니다.데모
주요 기능 11개의 실제 스크린샷. 클릭하면 원본 크기로 확대됩니다.
핵심 기능
SQL부터 Java 코드, 기술 문서, ERD까지 Claude AI가 즉각적인 인사이트를 제공합니다
/project-map 에서 드릴다운 카드로 전사 패키지 지도를 검색·탐색할 수 있고, 스토리는 Markdown 파일로 export 됩니다.MyBatisCallerIndex 의 mapper 클래스 단위 검증으로 같은 메서드명을 갖는 다른 매퍼의 false-positive 가 제거되어 결과 정확도가 크게 향상됐습니다./search?q=... 로 이동해 메뉴 카탈로그 + 분석 이력 두 종류 결과를 한 화면에 보여 줍니다. URL 파라미터로 진입하면 자동 검색되어 공유·새로고침에 안전./actuator/prometheus 엔드포인트로 Spring 자동 메트릭 + 도메인 커스텀 메트릭 4종 (claude_api_calls_total, claude_api_tokens_total, analysis_duration_seconds, pipeline_execution_total) 을 노출합니다. docker-compose --profile monitoring up -d 한 번으로 Prometheus + Grafana 가 함께 떠서 자동 프로비저닝된 "Claude Toolkit Overview" 대시보드 (10개 패널 — 호출 추이 / 토큰 / 분석 p95 / 파이프라인 성공률 / JVM Heap / HTTP) 를 즉시 볼 수 있습니다./admin/cost-optimizer 에서 분석 유형별 평균 토큰 / 승인률을 분석하여 Haiku / Sonnet / Opus 중 최적 모델을 자동 추천합니다. Anthropic 공식 단가표 기반 현재 비용 ↔ 추천 비용 비교 차트와 절감 가능 금액을 USD 로 표시하고, 단순 분석은 Haiku 로 전환하여 최대 80% 비용 절감 가능합니다.react-grid-layout 기반의 사용자별 홈 대시보드 — 편집 모드를 켜면 위젯을 드래그 / 리사이즈 / 표시·숨김 토글이 가능하고, 저장 버튼으로 백엔드 (UserDashboardLayout) 에 영속화되어 다른 기기에서도 동일하게 적용됩니다. 기본값 복원 버튼으로 언제든 초기화 가능하며, 새 위젯이 추가되어도 기존 사용자 레이아웃이 자동 보강됩니다.reactflow 기반 그래프 뷰가 추가되어 (Mermaid 차트와 토글) YAML 단계를 시각적으로 확인할 수 있습니다. 병렬 단계는 같은 컬럼의 다른 row 에 펼쳐지고, ${stepId.output} 컨텍스트 의존성과 dependsOn 명시 의존성이 자동으로 엣지로 그려지며, 조건부 step 은 주황색 엣지로 구분됩니다. 미니맵 + 줌 컨트롤도 제공합니다.helm/claude-toolkit) 를 동봉합니다. Deployment + Service + Ingress + Secret + PVC + HPA + ServiceMonitor 를 모두 포함하고, DB 옵션별 (h2 / mysql / postgresql / external) values 와 6가지 시나리오별 helm install 예시를 제공합니다. monitoring.serviceMonitor.enabled=true 로 prometheus-operator 와도 자동 연동됩니다.실행계획(EXPLAIN PLAN) 트리 시각화, ⚡ SSE 스트리밍 실시간 분석, Before/After 비교, 성능 히스토리 대시보드(Cost 추이 차트), AI 제안 SQL Diff 뷰, 배치 SQL 분석(최대 30개 일괄 리뷰, CSV 업로드), cron 스케줄 자동 실행, SQL Injection 보안 검사까지 SQL 개발의 모든 단계를 지원합니다.
코드 설계 패턴, 성능 병목, OWASP Top 10 보안 취약점을 Claude AI가 분석합니다. 프로젝트 컨텍스트(파일 스캔)를 주입하면 더 정확한 리뷰가 가능하며, 복잡도 분석, 리팩터링 제안, 테스트 코드 자동 생성도 지원합니다.
Oracle Stored Procedure, Java 클래스, MyBatis XML 등 다양한 소스코드를 입력하면 Markdown, Typst, HTML 형식의 기술 문서를 즉시 생성합니다. Mermaid erDiagram 형식의 ERD 다이어그램과 Oracle DDL 자동 생성도 지원합니다.
모든 분석 기능이 JSON API로 제공되어 GitHub Actions, Jenkins 등 CI/CD 파이프라인에서 직접 호출할 수 있습니다. 빌드 시마다 자동 코드 리뷰, PR에 AI 분석 결과 자동 코멘트 등의 자동화가 가능합니다.
시작하기
JDK 1.8 이상과 Claude API 키만 있으면 바로 시작할 수 있습니다
git clone https://github.com/Sangmoo/Claude-Java-Toolkit.git cd Claude-Java-Toolkit mvn package -DskipTests
java -jar claude-toolkit-ui/target/claude-toolkit-ui-*.jar # → http://localhost:8027
Settings → Claude API Key → 저장 # ~/.claude-toolkit/settings.json 에 저장됩니다
Settings → Oracle DB 연결 JDBC URL: jdbc:oracle:thin:@//host:1521/ORCL
REST API
웹 UI 없이도 모든 분석 기능을 JSON API로 호출할 수 있습니다
서버 상태, API 키, DB 연결 여부 확인
GET /api/v1/health
쿼리 성능·품질 분석, 인덱스 제안
POST /api/v1/sql/review
SQL Injection, 권한 노출 등 취약점 탐지
POST /api/v1/sql/security
Oracle EXPLAIN PLAN + AI 성능 분석
POST /api/v1/sql/explain
Java/Spring 설계·성능·패턴 분석
POST /api/v1/code/review
OWASP Top 10, 하드코딩 자격증명 탐지
POST /api/v1/code/security
소스코드 → Markdown 기술 문서
POST /api/v1/doc/generate
스키마 텍스트 또는 DB 직접 연결 ERD 생성
POST /api/v1/erd/analyze
설치 가이드
별도 서버 없이 로컬에서 바로 실행됩니다. JDK 1.8+, Maven 3.6+이 필요합니다. React 프론트엔드는 Maven 빌드 시 자동 빌드됩니다.
# Prerequisites: JDK 1.8+, Maven 3.6+ git clone https://github.com/Sangmoo/Claude-Java-Toolkit.git cd Claude-Java-Toolkit mvn package -DskipTests → React frontend auto-built (npm install + vite build) → BUILD SUCCESS
# Run the server (port 8027) java -jar claude-toolkit-ui/target/claude-toolkit-ui-*.jar # Open browser and configure http://localhost:8027/settings → Claude API Key 입력 → Oracle DB 연결 설정 (선택)