PostgreSQL MCP Server

PostgreSQL MCP 서버

PostgreSQL 데이터베이스 관리 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 기존 PostgreSQL 설정 분석, 구현 지침 제공, 데이터베이스 문제 디버깅을 지원합니다.

특징

1. 데이터베이스 분석( analyze_database )

PostgreSQL 데이터베이스 구성 및 성능 측정 항목을 분석합니다.

• 구성 분석
• 성과 지표
• 보안 평가
• 최적화를 위한 권장 사항

지엑스피1

2. 설정 지침( get_setup_instructions )

단계별 PostgreSQL 설치 및 구성 지침을 제공합니다.

• 플랫폼별 설치 단계
• 구성 권장 사항
• 보안 모범 사례
• 설치 후 작업

3. 데이터베이스 디버깅( debug_database )

일반적인 PostgreSQL 문제를 디버깅합니다.

• 연결 문제
• 성능 병목 현상
• 잠금 충돌
• 복제 상태

필수 조건

• 노드.js >= 18.0.0
• PostgreSQL 서버(대상 데이터베이스 작업용)
• 대상 PostgreSQL 인스턴스에 대한 네트워크 액세스

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 PostgreSQL MCP 서버를 자동으로 설치하려면:

수동 설치

1. 저장소를 복제합니다
2. 종속성 설치:
   npm install
3. 서버를 빌드하세요:
   npm run build
4. MCP 설정 파일에 추가:
   { "mcpServers": { "postgresql-mcp": { "command": "node", "args": ["/path/to/postgresql-mcp-server/build/index.js"], "disabled": false, "alwaysAllow": [] } } }

개발

• npm run dev - 핫 리로드로 개발 서버 시작
• npm run lint - ESLint 실행
• npm test - 테스트 실행

보안 고려 사항

1. 연결 보안
   • 연결 풀링을 사용합니다
   • 연결 시간 초과를 구현합니다
   • 연결 문자열을 검증합니다
   • SSL/TLS 연결을 지원합니다
2. 쿼리 안전
   • SQL 쿼리를 검증합니다
   • 위험한 작업을 방지합니다
   • 쿼리 시간 초과를 구현합니다
   • 모든 작업을 기록합니다
3. 입증
   • 다양한 인증 방식 지원
   • 역할 기반 액세스 제어를 구현합니다.
   • 비밀번호 정책을 시행합니다
   • 연결 자격 증명을 안전하게 관리합니다

모범 사례

1. 항상 적절한 자격 증명을 사용하여 보안 연결 문자열을 사용하세요.
2. 민감한 환경에 대한 프로덕션 보안 권장 사항을 따르세요.
3. 정기적으로 데이터베이스 성능을 모니터링하고 분석합니다.
4. PostgreSQL 버전을 최신 상태로 유지하세요
5. 적절한 백업 전략을 구현하세요
6. 더 나은 리소스 관리를 위해 연결 풀링을 사용하세요
7. 적절한 오류 처리 및 로깅 구현
8. 정기적인 보안 감사 및 업데이트

오류 처리

서버는 포괄적인 오류 처리를 구현합니다.

• 연결 실패
• 쿼리 시간 초과
• 인증 오류
• 권한 문제
• 리소스 제약

평가 및 테스트 실행

evals 패키지는 index.ts 파일을 실행하는 mcp 클라이언트를 로드하므로 테스트 사이에 다시 빌드할 필요가 없습니다. 전체 문서는 여기에서 확인할 수 있습니다.

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치 생성
3. 변경 사항을 커밋하세요
4. 지점으로 밀어 넣기
5. 풀 리퀘스트 만들기

특허

이 프로젝트는 AGPLv3 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.