Neon MCP Server — Claude Code MCP 서버

서버리스 Postgres인 Neon을 자연어로 관리하는 공식 MCP 서버. 프로젝트·브랜치·쿼리·마이그레이션을 Neon API로 수행한다.

Neon MCP Server는 서버리스 Postgres 서비스인 Neon을 Claude Code 같은 MCP 클라이언트에서 자연어로 관리하도록 해주는 공식(Neon Labs) MCP 서버입니다. 평소 Neon 콘솔이나 REST API, psql을 오가며 하던 작업을 AI 에이전트가 Neon API 호출로 대신 수행하게 만드는 다리 역할을 합니다.

핵심적으로 다루는 작업은 네 가지로 요약됩니다. 첫째, 프로젝트(Project) 생성·조회·관리. 둘째, Neon의 특징인 브랜치(Branch) 운영 — 프로덕션 데이터를 복사한 격리 브랜치를 즉석에서 만들어 실험하고, 검증 후 정리하는 흐름을 대화로 처리할 수 있습니다. 셋째, SQL 쿼리 실행 — 테이블 조회·집계 같은 읽기성 작업부터 데이터 변경까지. 넷째, 스키마 마이그레이션 — 테이블/컬럼 변경을 브랜치에서 시험한 뒤 반영하는 패턴이 Neon의 분기 모델과 잘 맞습니다.

이런 워크플로의 이점은 "DB 콘솔 ↔ 코드 에디터 ↔ 마이그레이션 도구"를 수동으로 오가던 컨텍스트 전환을 줄이고, 브랜치 기반 안전 실험을 자연어 한두 마디로 시작할 수 있다는 점입니다. 스키마 설계 초안, 샘플 쿼리 작성, 마이그레이션 시나리오 검토 같은 작업에서 특히 유용합니다.

누가 쓰면 좋은가: Neon을 백엔드 DB로 쓰는 풀스택·백엔드 개발자, 브랜치로 안전하게 실험하고 싶은 팀, AI 보조로 마이그레이션 초안을 빠르게 만들고 싶은 사람에게 적합합니다. 단, AI가 생성한 SQL·마이그레이션은 사람이 검토하고 적용하는 것을 전제로 사용하세요. 정확한 지원 도구 목록·인증 방식·원격(remote) 옵션 여부는 버전에 따라 달라질 수 있으니 공식 GitHub 저장소와 Neon 문서를 함께 확인할 것을 권장합니다.

언제 쓰나

Neon을 데이터베이스로 사용하는 프로젝트에서, Claude Code에게 프로젝트·브랜치 관리, SQL 쿼리 작성·실행, 스키마 마이그레이션 초안 작성을 맡기고 싶을 때 적합합니다. 특히 프로덕션을 건드리지 않고 브랜치에서 변경을 실험·검증한 뒤 반영하는 흐름, 또는 콘솔·psql·마이그레이션 도구를 오가는 컨텍스트 전환을 줄이고 싶을 때 유용합니다. 일회성 단순 조회보다, 반복적인 DB 작업이 많은 환경에서 가치가 큽니다.

설치

claude mcp add neon -- npx -y @neondatabase/mcp-server-neon start $NEON_API_KEY

설치 전 Neon 계정과 API 키(NEON_API_KEY)를 발급해 환경변수로 준비해야 합니다. 키는 셸 환경변수나 MCP 클라이언트의 env 설정으로 주입하고, 명령행에 평문으로 남기거나 저장소에 커밋하지 마세요. Node.js(npx) 실행 환경이 필요합니다. 등록 후 Claude Code에서 MCP 서버가 정상 연결됐는지, 노출되는 도구 목록이 의도대로인지 확인하세요. 원격(remote) 연결·OAuth 등 대안 방식이나 지원 도구 범위는 버전에 따라 다를 수 있으므로 공식 GitHub 저장소와 Neon 문서를 확인하는 것을 권장합니다.

필요 키(직접 발급, 플레이스홀더): NEON_API_KEY

보안 주의

이 서버는 NEON_API_KEY로 Neon 계정에 접근하므로, 키 권한 범위가 곧 노출 범위입니다. API 키는 프로젝트 생성·삭제, 브랜치 조작, SQL 실행 등 광범위한 작업을 수행할 수 있어 유출 시 데이터 손실·과금·삭제 위험으로 이어집니다. 키는 환경변수로만 다루고 절대 커밋·로그·출력하지 마세요. AI가 생성한 DELETE/DROP/TRUNCATE나 마이그레이션은 사람이 검토 후 적용하고, 가능하면 프로덕션이 아닌 브랜치에서 먼저 검증하세요. DB에 저장된 외부 입력(사용자 콘텐츠 등)이 쿼리 결과로 모델에 전달되면 prompt injection 가능성이 있으니 신뢰할 수 없는 데이터 처리 시 주의가 필요합니다.

자주 묻는 질문

Neon MCP Server는 무엇을 할 수 있나요?

Neon API를 통해 프로젝트 생성·조회, 브랜치 생성·관리, SQL 쿼리 실행, 스키마 마이그레이션 같은 작업을 Claude Code에서 자연어로 수행할 수 있습니다. 콘솔이나 psql을 직접 열지 않고 대화로 DB 작업을 진행하려는 용도에 맞습니다.

사용하려면 무엇이 필요한가요?

Neon 계정과 NEON_API_KEY가 필요하며, npx 실행을 위한 Node.js 환경이 있어야 합니다. 키는 환경변수로 주입하고 저장소에 커밋하지 마세요. 인증 방식과 지원 도구 범위는 버전에 따라 다를 수 있어 공식 문서 확인을 권장합니다.

AI가 프로덕션 데이터를 실수로 망가뜨릴 위험은 없나요?

API 키 권한 범위 내에서 삭제·변경이 가능하므로 위험이 존재합니다. Neon의 브랜치 기능으로 격리된 환경에서 먼저 검증하고, AI가 만든 파괴적 SQL이나 마이그레이션은 반드시 사람이 검토한 뒤 적용하는 것을 권장합니다.