AI 에이전트를 위한 안전한 SQL Server CLI 도구: SqlCli

실용적 조언

AI 에이전트에게 DB 접근 권한을 줄 때는 반드시 읽기 전용 화이트리스트 필터를 적용할 것
토큰 비용 절감을 위해 에이전트 응답 형식을 CSV로 설정할 것

섹션별 상세

기존 mssql-mcp-reader와 같은 도구들이 사용하는 문자열 매칭 방식의 보안 취약점을 지적했다. WITH 공통 테이블 식별자(CTE)를 사용해 DELETE 문을 시작하면 단순 필터는 이를 인지하지 못하지만, ScriptDom 파서는 이를 DeleteStatement 노드로 정확히 식별하여 차단한다. 이는 구문 분석 단계에서 악성 쿼리를 원천 봉쇄하는 메커니즘이다.

Windows 도메인 환경에서 AI 에이전트가 인증을 수행할 때 발생하는 기술적 난관을 NegotiateAuthentication API로 해결했다. 기존 도구들이 프로세스 전체를 특정 권한으로 실행해야 했던 것과 달리, 연결 수준에서 SSPI를 호출하여 자격 증명을 처리한다. 이 방식은 .NET 10 환경에서 구현되어 보안성과 편의성을 동시에 확보했다.

AI 에이전트와의 상호작용 최적화를 위해 세 가지 계층의 설정 구조를 도입했다. 보안 설정은 파일로만 관리하여 에이전트의 접근을 막고, 운영 설정과 앱 설정은 유연하게 조정 가능하도록 분리했다. 또한 --agent-help 기능을 통해 에이전트가 도구의 제약 사항과 사용법을 즉시 파악할 수 있는 부트스트래핑 메커니즘을 제공한다.

용어 해설

추상 구문 트리(AST): — 소스 코드의 구조를 트리 형태로 표현한 것이다. 쿼리의 단순 텍스트가 아닌 논리적 구조를 분석하여 DELETE 문이 포함되었는지 등을 정확히 식별하는 데 사용된다.
스크립트돔(ScriptDom): — Microsoft에서 제공하는 T-SQL 파서 라이브러리이다. SQL 쿼리를 분석하여 AST를 생성하며, 이를 통해 쿼리가 어떤 명령을 수행하려는지 구조적으로 파악할 수 있게 한다.
보안 지원 공급자 인터페이스(SSPI): — Windows의 보안 인증 인터페이스이다. 별도의 프로세스 권한 변경 없이도 네트워크 연결 시 도메인 자격 증명을 안전하게 사용할 수 있도록 지원한다.
토큰 효율성(Token Efficiency): — LLM이 처리하는 텍스트 단위인 토큰을 절약하는 정도이다. CSV와 같은 간결한 데이터 형식은 JSON보다 적은 토큰을 소모하여 비용을 절감하고 더 긴 문맥 유지를 가능하게 한다.

언급된 도구

SqlCli추천

AI 에이전트용 안전한 SQL Server 인터페이스

ScriptDom추천

T-SQL 구문 분석 및 AST 생성

DAB중립

Microsoft의 데이터 API 빌더 (엔티티 기반)

언급된 리소스

GitHubSqlCli GitHub Repository