본문으로 건너뛰기
hs-sql-agent

MCP 네이티브 · 페일 클로즈 · 6개 SQL 방언

AI 에이전트의 SQL 실행을 안전하게.

AI가 생성한 SQL과 데이터베이스 사이에 SQL 컴파일러와 접근 제어 경계를 둡니다. hs-sql-agent는 SQL을 파싱하고 검증한 뒤 대상 데이터베이스에서 의미를 안전하게 보존할 수 있는지와 접근 권한을 확인하고, 그다음에 데이터베이스별 SQL을 실행합니다.

docker compose up -d

SQL 실행 경계

AI가 생성한 SQL을 신뢰할 수 없는 입력으로 취급합니다.

중요한 것은 SQL을 생성할 수 있는지가 아닙니다. 해당 문장의 의미를 허용된 SQL 방언, 지원 기능, 접근 정책 안에서 안전하게 실행할 수 있는지 확인하는 것이 중요합니다.

안전한 데이터 변경

DML 승인은 확인 대화상자가 아니라 실행 프로토콜입니다.

UPDATE와 DELETE는 변경 전에 대상 행을 읽고, 승인 내용을 검증된 실행 계획과 행 집합 핑거프린트에 연결한 뒤 커밋 직전에 다시 확인합니다.

01
미리보기

변경을 실행하지 않고 영향을 받을 행을 먼저 확인합니다.

02
승인

MCP form Elicitation을 사용해 사용자의 명시적인 승인을 요구합니다.

03
재검증

커밋 트랜잭션에서 대상 행을 다시 조회하고 승인 당시 상태와 같은지 확인합니다.

04
커밋

실행 계획, 정책, 승인 챌린지, 행 수, 대상 행 집합이 모두 같을 때만 변경을 확정합니다.

공통 MCP, 6개 SQL 방언

이미 운영 중인 데이터베이스를 그대로 사용하세요.

SQL 컴파일러가 데이터베이스별 의미 차이를 명확하게 처리하고 MCP 클라이언트에는 공통으로 통제된 인터페이스를 제공합니다.

문서

첫 MCP 키부터 운영 환경까지.

설치, MCP, SQL 컴파일러, 관리, 통합, 운영, 개발이라는 실제 도입 순서에 맞춰 문서를 구성했습니다.