convez.ai
MCP ServerIntegração & APIsIntermediário
CRUDClass

MCP PostgreSQL CRUD Server

CRUDClass/mcp-pg-server

Servidor MCP para operações CRUD PostgreSQL com segurança SQL

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP baseado em Spring Boot que expõe operações CRUD completas do PostgreSQL como ferramentas para agentes de IA. Suporta leitura, escrita, DDL e validação SQL com prevenção de injeção.

Instalação

$npx convez-ai CRUDClass/mcp-pg-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Conectar agentes Claude a bancos PostgreSQL para consultas e modificações de dados
  • Automatizar operações de banco de dados através de prompts de IA
  • Executar transações complexas com validação e confirmação em duas etapas

Veredito

Ferramenta robusta e bem documentada para integração de PostgreSQL com agentes IA. Implementação segura com validação SQL via JSqlParser e suporte a múltiplos modos de transporte (HTTP e STDIO), pronta para produção com Docker.

README

A tradução para o português deste README ainda está na fila.

mcp-pg-server

License: MIT 中文说明

A PostgreSQL MCP (Model Context Protocol) server built with Spring Boot and Spring AI, exposing database CRUD operations as MCP tools for AI agents.

Features

  • Full CRUD tools — Query, Insert, Update, Delete, Batch, DDL, ListTables, DescribeTable
  • Read/write support — Unlike read-only MCP servers, this supports all DML and DDL operations
  • SQL validation — Built-in SQL injection prevention via JSqlParser
  • Bilingual i18n — Tool descriptions switch between Chinese and English via TOOL_LOCALE env var
  • MCP STREAMABLE transport — HTTP-based MCP protocol at /api/mcp
  • Docker-ready — Dockerfile and docker-compose.yml included

Quick Start

Prerequisites

  • Java 21+
  • Maven 3.9+
  • PostgreSQL 14+
  • Docker (optional)

Setup

# Clone
git clone https://github.com/CRUDClass/mcp-pg-server.git
cd mcp-pg-server

# Configure environment
cp .env.example .env
# Edit .env with your PostgreSQL connection

# Build
mvn package -DskipTests

# Run
java -jar target/pg-server-1.0.0.jar

Docker

docker compose up -d --build

Docker (STDIO Mode)

For MCP clients that communicate via standard input/output (e.g., Claude Desktop):

docker run -i --rm --init --pull=always \
  -e SPRING_PROFILES_ACTIVE=stdio \
  -e PG_HOST=your-host \
  -e PG_PORT=5432 \
  -e PG_DATABASE=your-db \
  -e PG_USERNAME=your-user \
  -e PG_PASSWORD=your-password \
  mcp-pg-server:latest

MCP Client Configuration:

{
  "mcpServers": {
    "pg-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init", "--pull=always",
        "-e", "SPRING_PROFILES_ACTIVE=stdio",
        "-e", "PG_HOST",
        "-e", "PG_PORT",
        "-e", "PG_DATABASE",
        "-e", "PG_USERNAME",
        "-e", "PG_PASSWORD",
        "mcp-pg-server:latest"
      ]
    }
  }
}

The --pull=always flag ensures the latest image is fetched. Omit it when using a locally built image.

MCP Client Configuration

Add to your MCP client's configuration:

{
  "mcpServers": {
    "pg-server": {
      "url": "http://localhost:15432/api/mcp"
    }
  }
}

MCP Tools

ToolDescription
queryExecute SELECT queries
insertInsert rows into a table
updateUpdate rows in a table
deleteDelete rows from a table
batchExecute multiple SQL statements in a transaction
ddlExecute DDL statements (CREATE TABLE, DROP TABLE)
listTablesList all tables in the database
describeTableDescribe a table's schema

Configuration

VariableDefaultDescription
SERVER_PORT15432Server port
PG_HOSTlocalhostPostgreSQL host
PG_PORT5432PostgreSQL port
PG_DATABASEhot_topicsDatabase name
PG_USERNAMErootDatabase user
PG_PASSWORD123456Database password
TOOL_LOCALEzhTool description language (zh or en)
SPRING_PROFILES_ACTIVE(none)Set to stdio to enable STDIO transport mode

License

MIT © CRUDClass

Ver o original no GitHub

Bom para

Relacionados