LLM(대규모 언어 모델)에 데이터베이스 연결을 제공하는 것은 데모에서는 멋지게 들리지만 실제 운영 환경에서는 끔찍하게 느껴지는 아이디어 중 하나입니다. 에이전트가 약간 잘못된 쿼리를 작성하고, 이제 여러분은 팀원들에게 orders 테이블이 비어 있다는 것을 설명해야 합니다.

그래서 제가 AI 에이전트(제 경우 Claude Desktop)가 SQLite 데이터베이스에 대한 질문에 답변하도록 만들고 싶었을 때, 저는 읽기-쓰기 연결을 건네주고 최상의 결과를 바라는 방식은 원하지 않았습니다. 그래서 에이전트에게 읽기 전용 SQL 접근 권한을 제공하는 작은 MCP 서버를 구축했고, 이 '읽기 전용'이라는 의미를 두 개의 독립적인 보호 계층으로 구현했습니다.

작동 방식과 중요한 설계 결정 사항은 다음과 같습니다.

전체 소스: github.com/skycandykey1/mcp-sqlite-server (MIT).

MCP에 대한 30초 개요

Model Context Protocol (MCP)은 AI 앱을 도구 및 데이터와 연결하기 위한 공개 표준입니다. MCP 클라이언트 (Claude Desktop, Claude Code, Cursor 등)는 세 가지 종류의 기능을 노출하는 MCP _서버_에 연결됩니다:

• 도구(Tools) — 모델이 호출할 수 있는 함수(query, list_tables 등)
• 리소스(Resources) — 모델이 가져올 수 있는 읽기 전용 데이터 (스키마, 파일)
• 프롬프트(Prompts) — 재사용 가능한 프롬프트 템플릿

Python SDK는 이를 몇 가지 데코레이터로 변환하는 고수준 헬퍼인 FastMCP를 제공합니다. 흥미로운 부분은 프로토콜 자체가 아니라 도구 뒤에 있는 안전 설계입니다.

설계: 위험한 부분을 프로토콜에서 분리하기

첫 번째 결정 사항은 다음과 같습니다: 읽기 전용 안전 로직은 MCP 의존성이 전혀 없습니다. 이 로직은 MCP에 대해 아무것도 알지 못하는 일반 모듈(db.py)에 존재하므로, 표준 라이브러리만으로 단위 테스트를 할 수 있습니다. 서버(server.py)는 얇은 래퍼(wrapper)입니다.

이 분리는 중요합니다: 절대 잘못되어서는 안 되는 부분(쓰기 보호)은 MCP 클라이언트를 구동하지 않고도 독립적으로 테스트할 수 있기 때문입니다.

두 개의 쓰기 보호 계층

단일 방어 장치는 단일 실패 지점입니다. 따라서 쓰기 보호는 두 번, 독립적으로 발생합니다.

Layer 1 — 엔진 수준에서 데이터베이스를 읽기 전용으로 열기:

import sqlite3

def connect(path: str) -> sqlite3.Connection:
...

?mode=ro는 SQLite에게 파일을 읽기 전용으로 열도록 지시하며, PRAGMA query_only는 같은 바지 위에 덧댄 두 번째 안전장치입니다. 모든 INSERT/UPDATE/DELETE는 엔진 자체에서 OperationalError를 발생시킵니다.

Layer 2 — 실행 전에 SELECT가 아닌 것은 거부하기:

def _ensure_read_only(sql: str) -> str:
    stmt = sql.strip().rstrip(";").strip()
    if not stmt:
...

이것은 모델에게 원시 엔진 예외 대신(

가장 중요한 테스트는 SELECT 쿼리가 작동하는지 여부가 아니라, 스테이트먼트 가드(statement guard)를 우회하더라도 쓰기 작업이 실패하는지 여부입니다:

def test_readonly_connection_blocks_writes_even_if_guard_bypassed():
    with db.session(_make_db()) as c:  # _make_db()는 임시 샘플 DB를 생성합니다.
        try:
... 

이것이 하나의 테스트에 담긴 전체 가치 제안(value proposition)입니다: 깊이 있는 방어(defense in depth)가 증명되었습니다.

핵심 요약 (Takeaways)

• AI 에이전트에게 권한을 부여할 때는, 작업을 수행하는 데 필요한 최소한의 권한만 주어야 합니다. 읽기 전용 접근 방식은 위험 부담 없이