Servidor MCP de PostgreSQL

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona funciones de gestión de bases de datos PostgreSQL. Este servidor ayuda a analizar las configuraciones existentes de PostgreSQL, proporciona orientación para la implementación y depura problemas de la base de datos.

Características

1. Análisis de base de datos ( analyze_database )

Analiza la configuración de la base de datos PostgreSQL y las métricas de rendimiento:

• Análisis de configuración

• Métricas de rendimiento

• Evaluación de seguridad

• Recomendaciones para la optimización

// Example usage
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "analysisType": "performance" // Optional: "configuration" | "performance" | "security"
}

2. Instrucciones de configuración ( get_setup_instructions )

Proporciona una guía paso a paso para la instalación y configuración de PostgreSQL:

• Pasos de instalación específicos de la plataforma

• Recomendaciones de configuración

• Mejores prácticas de seguridad

• Tareas posteriores a la instalación

// Example usage
{
  "platform": "linux", // Required: "linux" | "macos" | "windows"
  "version": "15", // Optional: PostgreSQL version
  "useCase": "production" // Optional: "development" | "production"
}

3. Depuración de bases de datos ( debug_database )

Depurar problemas comunes de PostgreSQL:

• Problemas de conexión

• Cuellos de botella en el rendimiento

• Conflictos de bloqueo

• Estado de replicación

// Example usage
{
  "connectionString": "postgresql://user:password@localhost:5432/dbname",
  "issue": "performance", // Required: "connection" | "performance" | "locks" | "replication"
  "logLevel": "debug" // Optional: "info" | "debug" | "trace"
}

Related MCP server: Postgres MCP Pro

Prerrequisitos

• Node.js >= 18.0.0

• Servidor PostgreSQL (para operaciones de base de datos de destino)

• Acceso de red a instancias de PostgreSQL de destino

Instalación

Instalación mediante herrería

Para instalar PostgreSQL MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

1. Clonar el repositorio

2. Instalar dependencias:

   npm install

3. Construir el servidor:

   npm run build

4. Agregar al archivo de configuración de MCP:

   {
     "mcpServers": {
       "postgresql-mcp": {
         "command": "node",
         "args": ["/path/to/postgresql-mcp-server/build/index.js"],
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }

Desarrollo

• npm run dev : inicia el servidor de desarrollo con recarga activa

• npm run lint - Ejecutar ESLint

• npm test - Ejecutar 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

   • Admite conexiones SSL/TLS

2. Seguridad de consultas

   • Valida consultas SQL

   • Previene operaciones peligrosas

   • Implementa tiempos de espera de consultas

   • Registra todas las operaciones

3. Autenticación

   • Admite múltiples métodos de autenticación

   • Implementa control de acceso basado en roles

   • Hace cumplir las políticas de contraseñas

   • Gestiona las credenciales de conexión de forma segura

Mejores prácticas

1. Utilice siempre cadenas de conexión seguras con credenciales adecuadas

2. Siga las recomendaciones de seguridad de producción para entornos sensibles

3. Supervisar y analizar periódicamente el rendimiento de la base de datos

4. Mantenga la versión de PostgreSQL actualizada

5. Implementar estrategias de respaldo adecuadas

6. Utilice la agrupación de conexiones para una mejor gestión de recursos

7. Implementar un manejo y registro de errores adecuados

8. Auditorías y actualizaciones de seguridad periódicas

Manejo de errores

El servidor implementa un manejo integral de errores:

• Fallos de conexión

• Tiempos de espera de consulta

• Errores de autenticación

• Problemas de permisos

• Limitaciones de recursos

Ejecución de evaluaciones y pruebas

El paquete evals carga un cliente mcp que ejecuta el archivo index.ts, por lo que no es necesario reconstruir entre pruebas. Puede consultar la documentación completa aquí .

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia AGPLv3: consulte el archivo de LICENCIA para obtener más detalles.