MCP Postgres 쿼리 서버

Claude Desktop 및 기타 MCP 클라이언트와 함께 작동하도록 설계된, 읽기 전용 모드에서 PostgreSQL 데이터베이스를 쿼리하기 위한 MCP(Model Context Protocol) 서버 구현입니다.

개요

이 프로젝트는 다음을 제공하는 MCP(Model Context Protocol) 서버를 구현합니다.

1. PostgreSQL 데이터베이스에 대한 안전하고 읽기 전용 인터페이스
2. MCP 프로토콜을 통한 Claude Desktop과의 통합
3. SELECT 쿼리만 실행되도록 하는 SQL 쿼리 검증
4. 쿼리 시간 초과 보호(10초)

필수 조건

• Node.js(v14 이상)
• npm(Node.js와 함께 제공)
• PostgreSQL 데이터베이스(명령줄을 통해 제공되는 연결 세부 정보)

설치

지엑스피1

Claude Desktop에 연결

Claude Desktop을 구성하여 MCP 서버를 자동으로 시작하고 연결할 수 있습니다.

1. Claude Desktop 구성 파일에 접근합니다.
   • 클로드 데스크톱 열기
   • 설정 > 개발자 > 구성 편집으로 이동하세요.
   • 이렇게 하면 기본 텍스트 편집기에서 구성 파일이 열립니다.
2. claude_desktop_config.json 의 mcpServers 섹션에 postgres-query-server를 추가합니다.

3. /path/to/your/ 프로젝트 디렉토리의 실제 경로로 바꾸세요.
4. PostgreSQL 연결 문자열을 실제 데이터베이스 자격 증명으로 바꾸세요.
5. 파일을 저장하고 Claude Desktop을 다시 시작하세요. 이제 MCP 서버가 설정의 MCP 서버 선택 드롭다운에 나타납니다.

구성 예

postgres-query를 사용한 구성 파일의 전체 예는 다음과 같습니다.

구성 업데이트

Claude Desktop 구성을 업데이트하려면:

1. 클로드 데스크톱 열기
2. 설정 > 개발자 > 구성 편집으로 이동하세요.
3. 구성 파일을 변경하세요
4. 파일을 저장하세요
5. 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.
6. MCP 서버 코드를 업데이트한 경우 재시작하기 전에 npm run build 로 다시 빌드해야 합니다.

특징

• 읽기 전용 데이터베이스 액세스 : 보안을 위해 SELECT 쿼리만 허용됩니다.
• 쿼리 검증 : 잠재적으로 유해한 SQL 작업을 방지합니다.
• 시간 초과 보호 : 10초 이상 실행되는 쿼리는 자동으로 종료됩니다.
• MCP 프로토콜 지원 : 모델 컨텍스트 프로토콜의 완전한 구현
• JSON 응답 형식 : 쿼리 결과는 구조화된 JSON 형식으로 반환됩니다.

API

도구

쿼리-포스트그레스

구성된 PostgreSQL 데이터베이스에 대해 읽기 전용 SQL 쿼리를 실행합니다.

매개변수:

• query (문자열): 실행할 SQL SELECT 쿼리

응답:

• JSON 객체에는 다음이 포함됩니다.
  • rows : 결과 집합 행
  • rowCount : 반환된 행 수
  • fields : 열 메타데이터

예:

개발

주요 서버 구현은 src/index.ts 에 있습니다. 주요 구성 요소는 다음과 같습니다.

• PostgreSQL 연결 풀 설정
• 쿼리 검증 논리
• MCP 서버 구성
• 도구 및 리소스 정의

서버의 동작을 수정하려면 다음을 수행하세요.

• isReadOnlyQuery() 에서 쿼리 검증 논리를 편집합니다.
• MCP 서버에 추가 도구 또는 리소스 추가
• 쿼리 시간 초과 기간을 수정합니다(현재 10초)

보안 고려 사항

• 서버는 모든 쿼리를 검증하여 읽기 전용인지 확인합니다.
• 데이터베이스에 대한 연결은 SSL을 사용합니다.
• 쿼리 시간 초과로 인해 리소스 고갈이 방지됩니다.
• 쓰기 작업이 허용되지 않습니다.
• 데이터베이스 자격 증명은 파일에 저장되지 않고 명령줄 인수를 통해 직접 전달됩니다.

특허

아이에스씨

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.