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

Firebird · MCP

AI 에이전트용 Firebird MCP 서버.

hs-sql-agent의 MCP surface, 타입 기반 SQL 컴파일러, 접근 정책, Safe DML, Audit 경계를 통해 AI Client를 Firebird에 안전하게 연결합니다.

01

하나의 통제된 MCP surface

모델에 unrestricted database connection을 넘기지 않고 Firebird를 노출합니다.

02

Dialect-aware compiler

Firebird 고유 SQL 의미를 명시적인 source / target capability 경계 안에서 처리합니다.

03

실행 전에 Policy 적용

Database scope, table policy, Tool 제한, Rate Limit, Safe DML, Audit을 커밋보다 먼저 적용합니다.

Firebird도 컴파일러 경계 뒤에 둡니다

모델이 생성한 Firebird SQL을 데이터베이스 자체가 실행할 수 있다는 이유만으로 신뢰하지 않습니다. SQL은 먼저 타입 기반 validation과 capability pipeline에 들어갑니다.

Provider support는 연결, metadata discovery, 지원 statement 컴파일, Policy 아래 실행이 가능하다는 뜻입니다. 모든 벤더 전용 문법을 자동 허용한다는 뜻은 아닙니다.

Schema를 추측하기 전에 Metadata를 사용합니다

MCP Client는 Firebird SQL을 만들기 전에 내장 metadata Tool로 schema, table, column을 확인할 수 있습니다. 무작정 schema를 추측하는 일을 줄이고 discovery를 같은 인증된 database scope 안에 유지합니다.

  • get_schemas
  • get_tables
  • get_columns
  • execute_query_sql
  • execute_dml_sql

의미를 증명할 수 없으면 거부합니다

Firebird도 다른 Provider와 같은 규칙을 따릅니다. 지원하지 않는 문법이나 증명되지 않은 cross-provider semantics는 올바른 validation / capability 경계에서 거부하며, 동작이 다른 SQL로 조용히 바꾸지 않습니다.

왜 Firebird 계정 정보를 AI에 직접 주지 않아야 할까요?

MCP 클라이언트가 데이터베이스 자격 증명을 직접 가지면 모델의 권한 경계는 사실상 해당 계정이 할 수 있는 작업에 의존하게 됩니다. hs-sql-agent는 실제 Firebird 연결을 서버에 유지하고 SQL 실행 전에 컴파일러, MCP 키 범위, 테이블 정책, 도구 제한, 런타임 제한을 확인합니다.

따라서 지원되는 원시 SQL의 표현력은 유지하면서 SQL을 생성할 수 있다는 사실이 무제한 데이터베이스 권한으로 이어지지 않게 할 수 있습니다.

  • 지원되는 구문에서는 원시 SQL 사용 가능
  • 데이터베이스 자격 증명은 서버 경계 안에 유지
  • 안전한 의미를 증명할 수 없으면 실행 전에 거부
  • DML은 사람의 명시적 승인을 요구하도록 설정 가능