PostgreSQL MCP

PostgreSQL MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona capacidades de ejecución de consultas directas a bases de datos PostgreSQL. Este servidor permite la ejecución de consultas SQL personalizadas contra bases de datos PostgreSQL con soporte para consultas parametrizadas y tiempos de espera configurables. Este proyecto está diseñado específicamente para su uso con el Cursor IDE.

Requisitos previos

• Node.js >= 18.0.0
• Servidor PostgreSQL (para operaciones de base de datos de destino)
• Acceso de red a instancias PostgreSQL de destino

Instalación

Instalación mediante Smithery

Para instalar PostgreSQL Database Query Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @1Levick3/postgresql-mcp-server --client claude

Instalación manual

1. Clona el repositorio
2. Instala las dependencias:

   npm install
   

3. Compila el servidor:

   npm run build
   

4. Añade al archivo de configuración de MCP:

    {
      "mcpServers": {
        "postgresql-mcp": {
          "command": "node",
          "args": ["/Users/1Levick3/Desktop/postgresql-mcp-server/build/index.js"],
          "disabled": false,
          "alwaysAllow": [],
          "env": {
            "POSTGRES_CONNECTION_STRING": "postgresUrl",
            "POSTGRES_SSL_CERT_PATH": "/Users/1levick3/Desktop/root.crt"
          }
        }
      }
    }
   

Desarrollo

• npm run dev - Inicia el servidor de desarrollo con recarga en caliente
• npm run lint - Ejecuta ESLint
• npm test - Ejecuta las pruebas

Consideraciones de seguridad

1. Seguridad de la conexión
   • Utiliza agrupación de conexiones
   • Implementa tiempos de espera de conexión
   • Valida cadenas de conexión
   • Soporta conexiones SSL/TLS

Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de características
3. Realiza commit de tus cambios
4. Sube los cambios a la rama
5. Crea una solicitud de extracción