Claude와 MCP로 구축하는 PostgreSQL Text-to-SQL 시스템 완전 정복

개요

이 글에서는 Anthropic의 Claude Desktop 애플리케이션과 Model Context Protocol(MCP)을 활용하여 PostgreSQL 데이터베이스에 자연어(Text-To-SQL) 쿼리를 실행하는 방법에 대해 다룬다. Claude를 통해 SQL 문법에 익숙하지 않은 사용자도 직관적으로 데이터를 조회할 수 있으며, 이는 데이터 활용의 접근성을 대폭 향상시킬 수 있다.

설명

Claude Desktop은 자연어 처리 기반의 AI 어시스턴트로, MCP(Model Context Protocol)를 통해 PostgreSQL 데이터베이스와 연동이 가능하다. Claude가 자연어 질의를 해석하여 자동으로 SQL 쿼리를 생성하고 실행 결과를 반환함으로써, 비개발자도 직관적인 방식으로 데이터에 접근할 수 있다.

특징

1. 손쉬운 연동 설정
2. 자연어 기반 질의 처리
3. MCP 기반 통신
4. 일부 제한 사항
   • 단일 DB 인스턴스만 지원
   • SELECT (읽기 전용) 쿼리만 가능
   • Claude Desktop 환경에서만 작동

설정방법

1. Claude Desktop 및 Node.js 설치

2. MCP 서버 설정을 위한 JSON 구성

Claude실행 후 설정 -> 설정편집

claude_desktop_config.json 열기

mcp 지원 프로토콜 페이지(https://github.com/modelcontextprotocol/servers/tree/main/src/postgres)에서 postgresql 설정 json데이터 복사 -> claude_desktop_config.json에 붙여넣기

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://<계정>@<host>:<port>/<dbname>"
      ]
    }
  }
}

 

3. Claude 재시작

재시작 후 MCP Tool 확인

4. 자연어 질문

자연어로 질문

Claude가 시스템의 도구를 사용할 수 있도록 허용

5. 결과 확인

일부 제한 사항

• 단일 DB 인스턴스만 지원
• SELECT (읽기 전용) 쿼리만 가능
• Claude Desktop 환경에서만 작동

결론

Claude와 MCP를 결합한 PostgreSQL 연동 시스템은 데이터 접근성을 획기적으로 높일 수 있는 방안이다. 비개발자도 데이터를 자유롭게 조회할 수 있어, 기업의 데이터 기반 의사결정 속도를 향상시킬 수 있다. 다만, 현재는 단일 인스턴스, 읽기 전용 쿼리 제한, Desktop 앱 환경이라는 제약이 있어 대규모 운영 환경에 적용하려면 한계가 존재한다.

참고문헌

• Claude 다운로드: https://claude.ai/download
• Node.js 다운로드: https://nodejs.org/ko/download
• MCP 서버 가이드: https://modelcontextprotocol.io/quickstart/server
• PostgreSQL MCP 서버 코드: https://github.com/modelcontextprotocol/servers/tree/main/src/postgres