go-mcp-postgres

개요

https://github.com/Zhwt/go-mcp-mysql/ 에서 코드를 복사하고 AI의 도움을 받아 MySQL에서 Postgres로 DB를 변경했습니다. Postgres와의 상호 작용 및 자동화를 위한 부담 없는 즉시 사용 가능한 모델 컨텍스트 프로토콜(MCP) 서버입니다. Node.js나 Python 환경이 필요하지 않습니다. 이 서버는 MySQL 데이터베이스 및 테이블에 대한 CRUD 작업을 수행하는 도구와 예기치 않은 쓰기 작업을 방지하기 위한 읽기 전용 모드를 제공합니다. --with-explain-check 플래그를 추가하여 쿼리 실행 전에 EXPLAIN 문을 사용하여 MCP 서버가 쿼리 계획을 확인하도록 할 수도 있습니다.

이 기능은 현재 진행 중이므로 아직 생산에 사용할 준비가 되지 않았을 수 있습니다.

Related MCP server: Filesystem MCP Server

설치

최신 릴리스를 받아서 $PATH 나 쉽게 접근할 수 있는 곳에 넣어두세요.
Go가 설치되어 있다면 소스에서 빌드할 수 있습니다.

지엑스피1

용법

방법 A: stdio 모드에 명령줄 인수 사용

{ "mcpServers": { "postgres": { "command": "go-mcp-postgres", "args": [ "--dsn", "postgresql://user:pass@host:port/db" ] } } }

참고: $PATH 외부에 바이너리를 넣은 경우 go-mcp-postgres 바이너리의 전체 경로로 바꿔야 합니다. 예를 들어, 바이너리를 다운로드 폴더에 넣은 경우 다음 경로를 사용할 수 있습니다.

{ "mcpServers": { "postgres": { "command": "C:\\Users\\<username>\\Downloads\\go-mcp-postgres.exe", "args": [ ... ] } } }

방법 B: sse 모드에 명령줄 인수 사용

./go-mcp-postgres --t sse --ip xxxx --port nnnn --dsn postgresql://user:pass@host:port/db --lang en

선택적 플래그

--lang : 언어 옵션(en/zh-CN)을 설정하고, 기본값은 시스템 언어입니다.
--read-only 플래그를 추가하여 읽기 전용 모드를 활성화하세요. 이 모드에서는 list , read_ , desc_ 로 시작하는 도구만 사용할 수 있습니다. 이 플래그를 추가한 후에는 MCP 서버를 새로 고치거나 다시 시작하세요.
기본적으로 CRUD 쿼리는 먼저 EXPLAIN ? 문을 사용하여 생성된 쿼리 계획이 예상 패턴과 일치하는지 확인합니다. 이 동작을 비활성화하려면 --with-explain-check 플래그를 추가하세요.

도구

다국어 지원: 모든 도구 설명은 언어 매개변수를 기반으로 자동으로 현지화됩니다.

자체 언어 지원을 추가하려면 [locales](i18n용) 폴더를 참조하세요. 명령줄에서 사용하려면 새 locales/xxx/active-xx.toml 파일을 생성해야 합니다.

스키마 도구

list_database
- ${mcp.tool.list_database.desc}
- 매개변수: 없음
- 반환값: 일치하는 데이터베이스 이름 목록입니다.
list_table
- ${mcp.tool.list_table.desc}
- 매개변수:
  - name : 제공된 경우 지정된 이름을 가진 테이블을 나열하고, 그렇지 않은 경우 모든 테이블을 나열합니다.
- 반환값: 일치하는 테이블 이름 목록입니다.
create_table
- ${mcp.tool.create_table.desc}
- 매개변수:
  - query : 테이블을 생성하기 위한 SQL 쿼리입니다.
- 반환: 영향을 받은 행 x개.
alter_table
- Postgres 서버의 기존 테이블을 변경합니다. LLM은 기존 테이블이나 열을 삭제하지 않도록 설정됩니다.
- 매개변수:
  - query : 테이블을 변경하는 SQL 쿼리입니다.
- 반환: 영향을 받은 행 x개.
desc_table
- 표의 구조를 설명하세요.
- 매개변수:
  - name : 설명하려는 테이블의 이름입니다.
- 반환값: 테이블의 구조.

데이터 도구

read_query
- 읽기 전용 SQL 쿼리를 실행합니다.
- 매개변수:
  - query : 실행할 SQL 쿼리입니다.
- 반환값: 쿼리 결과.
write_query
- SQL 쿼리를 실행합니다.
- 매개변수:
  - query : 실행할 SQL 쿼리입니다.
- 반환값: 영향을 받은 행 x개, 마지막 삽입 ID: <last_insert_id>.
update_query
- 업데이트 SQL 쿼리를 실행합니다.
- 매개변수:
  - query : 실행할 SQL 쿼리입니다.
- 반환: 영향을 받은 행 x개.
delete_query
- 삭제 SQL 쿼리를 실행합니다.
- 매개변수:
  - query : 실행할 SQL 쿼리입니다.
- 반환: 영향을 받은 행 x개.
count_query
- 특정 테이블의 행 수를 쿼리합니다.
- 매개변수:
  - name : 계산할 테이블의 이름입니다.
- 반환값: 테이블의 행 번호.