PostgreSQL MCP 서버 — 클로드에 데이터베이스 연결하기 (2026)

클로드가 PostgreSQL 스키마를 보고 읽기 쿼리를 실행하도록 연결하는 방법입니다. 아카이브된 공식 서버 사용법과 권장 대안, 안전한 설정을 정리했습니다.

PostgreSQL MCP 서버는 클로드가 데이터베이스의 스키마를 살펴보고 읽기 쿼리를 실행하도록 연결해 줍니다. 다만 한 가지 중요한 점 — 공식 레퍼런스 서버(@modelcontextprotocol/server-postgres)는 현재 공식 저장소에서 아카이브로 옮겨져 적극적인 유지보수 대상이 아닙니다. 그래서 ① 아카이브된 공식 서버를 쓰는 법과 ② 더 권장되는 대안을 함께 정리합니다.

PostgreSQL MCP — 설정 4단계PostgreSQL MCP — 설정 4단계① 읽기 전용 계정권한 최소화② 연결 문자열postgresql://…③ 등록npx 또는 Docker④ 질의스키마·읽기 쿼리

무엇을 할 수 있나

이 서버는 읽기 전용(read-only) 접근을 제공합니다. 즉 테이블 구조(스키마)를 자원으로 노출하고, 조회용 쿼리를 실행하는 용도입니다. 데이터를 바꾸는 작업이 아니라 "내 DB를 클로드가 이해하고 질문에 답하게" 하는 쪽에 맞습니다.

방법 1 — 아카이브된 공식 서버 (주의해서 사용)

패키지는 @modelcontextprotocol/server-postgres이고, 연결 문자열을 인자로 넘깁니다. claude_desktop_config.json 예시는 다음과 같습니다.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

마지막 인자 postgresql://localhost/mydb를 본인 DB의 연결 문자열로 바꾸면 됩니다. 단, 이 서버는 아카이브 상태라 보안·호환성 업데이트가 멈춰 있을 수 있으니 그 점을 감안하세요.

방법 2 — 유지보수되는 대안 (권장)

적극적으로 관리되는 데이터베이스 MCP 서버는 MCP 서버를 찾는 곳에서 소개한 레지스트리·디렉터리에서 찾을 수 있습니다. 또한 관리형 Postgres를 쓴다면 Supabase의 공식 MCP처럼 벤더가 직접 제공하는 서버를 고려하는 편이 안전합니다.

안전하게 — 데이터베이스는 특히 조심

DB 연결은 민감하므로 다음을 권합니다. 첫째, 읽기 전용·최소 권한 계정을 따로 만들어 연결하세요. 둘째, 연결 문자열에는 비밀번호가 들어가므로 외부에 노출되지 않게 관리하세요(MCP 커넥터 보안). 셋째, 운영 DB보다 사본·읽기 복제본을 우선 고려하세요.

문제해결

서버가 안 보이거나 연결 오류가 나면 문제해결 가이드를 참고하세요. 연결 문자열 형식·방화벽·권한이 흔한 원인입니다.

관련 글

다른 서버는 Filesystem 서버GitHub MCP 서버, 용도별 추천은 추천 MCP 서버, 전체 지도는 커넥터·MCP 카탈로그를 보세요. 공식 출처는 modelcontextprotocol/servers-archived (postgres)입니다.

작성·기준: 2026년 6월. 공식 PostgreSQL 레퍼런스 서버는 아카이브 저장소에 있으며 유지보수가 멈췄을 수 있습니다. 설정·대안은 공식 문서와 레지스트리를 함께 확인해 주세요. 이 글은 비공식 안내입니다.

이어서 읽어보세요

이 주제, 커뮤니티에서 이야기 나눠요

'클로드 코딩' 게시판의 첫 글을 남겨보세요. 같은 주제를 보는 사람들이 모입니다.