PostgreSQL MCP Server

PostgreSQL 데이터베이스를 Cursor AI에서 바로 조회할 수 있게 해주는 MCP 서버입니다.

특징

• 🚀 간단한 설치: npx 명령어 하나로 즉시 사용
• 🔒 안전한 접근: SELECT 쿼리만 허용
• 📊 3가지 핵심 도구 제공
  • list_tables: 모든 테이블 목록 조회
  • describe_table: 테이블 스키마 확인
  • query: SELECT 쿼리 실행

설치 방법

Cursor에서 사용하기

~/.cursor/mcp.json 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "postgres-mcp": {
      "command": "npx",
      "args": ["-y", "postgres-mcp-server@latest"],
      "env": {
        "DB_HOST": "your-database-host",
        "DB_PORT": "5432",
        "DB_NAME": "your-database-name",
        "DB_USER": "your-username",
        "DB_PASSWORD": "your-password"
      }
    }
  }
}

Cursor를 재시작하면 postgres-mcp가 활성화됩니다.

사용 예제

Cursor AI Chat에서:

• "데이터베이스의 모든 테이블을 보여줘"
• "users 테이블의 스키마를 알려줘"
• "SELECT * FROM products LIMIT 10 쿼리를 실행해줘"

환경 변수

| 변수 | 설명 | 기본값 | |------|------|--------| | DB_HOST | PostgreSQL 호스트 | localhost | | DB_PORT | PostgreSQL 포트 | 5432 | | DB_NAME | 데이터베이스 이름 | postgres | | DB_USER | 사용자 이름 | postgres | | DB_PASSWORD | 비밀번호 | (필수) |

보안

• SELECT 쿼리만 허용: INSERT, UPDATE, DELETE 등은 차단됩니다
• 최대 100행 제한: 대용량 데이터 조회 시 자동으로 제한됩니다

라이선스

MIT