Simple PostgreSQL MCP Server

Um servidor MCP para executar consultas SQL em bancos de dados PostgreSQL com permissões configuráveis.

Documentação

Simple PostgreSQL MCP Server

Um servidor minimalista do Model Context Protocol (MCP) para executar consultas SQL em bancos de dados PostgreSQL com permissões configuráveis.

Recursos

  • Executa consultas SQL com acesso opcional somente leitura ou gravação
  • Modo em nível de servidor (somente leitura/gravação) configurável via linha de comando
  • Retorna resultados estruturados com metadados
  • Configuração simples usando uma string de conexão PostgreSQL

Primeiros Passos

  1. Clone o repositório
    git clone https://github.com/perrypixel/Simple-Postgres-MCP
    cd Simple-Postgres-MCP
    
  2. Instale as dependências
    npm install
    
  3. Compile o projeto
    npm run build
    

Configuração do MCP

Adicione o seguinte à configuração do seu cliente MCP (mcp.json):

Modo de Gravação (padrão)

{
  "mcpServers": {
    "simple-postgresql-mcp": {
      "command": "node",
      "args": [
        "/path/to/build/index.js",
        "postgresql://username:password@localhost:5432/database_name",
        "write"
      ]
    }
  }
}

Modo Somente Leitura

{
  "mcpServers": {
    "simple-postgresql-mcp": {
      "command": "node",
      "args": [
        "/path/to/build/index.js",
        "postgresql://username:password@localhost:5432/database_name",
        "readonly"
      ]
    }
  }
}

Nota: Atualize o caminho na configuração para apontar para o arquivo index.js dentro da sua pasta build.

Uso

  1. Copie a configuração MCP apropriada (modo somente leitura ou gravação) para o mcp.json da sua ferramenta (ex.: Cursor, Windsurf, Copilot, etc.).
  2. Inicie seu cliente MCP. O servidor está pronto para uso!

Suporte

Se você achar esta ferramenta útil, pode apoiar o desenvolvimento: