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"
}

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

Clonar el repositorio
Instalar dependencias:
npm install
Construir el servidor:
npm run build
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

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
Seguridad de consultas
- Valida consultas SQL
- Previene operaciones peligrosas
- Implementa tiempos de espera de consultas
- Registra todas las operaciones
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

Utilice siempre cadenas de conexión seguras con credenciales adecuadas
Siga las recomendaciones de seguridad de producción para entornos sensibles
Supervisar y analizar periódicamente el rendimiento de la base de datos
Mantenga la versión de PostgreSQL actualizada
Implementar estrategias de respaldo adecuadas
Utilice la agrupación de conexiones para una mejor gestión de recursos
Implementar un manejo y registro de errores adecuados
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

Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
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.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Facilita la gestión y optimización de bases de datos PostgreSQL, ofreciendo análisis, orientación de configuración y depuración, al tiempo que garantiza operaciones de base de datos seguras y eficientes.

Related Resources

Reddit Discussion about this server

Related MCP Servers

PostgreSQL MCP Server
vinsidious
-
security
F
license
-
quality
Provides read-only access to PostgreSQL databases, enabling users to inspect database schemas and execute read-only queries through a Model Context Protocol server.
Last updated -
3
JavaScript
Model Context Protocol PostgreSQL Server
endaoment
-
security
F
license
-
quality
A server that allows AI models to interact with PostgreSQL databases through a standardized protocol, providing database schema information and SQL query execution capabilities.
Last updated -
JavaScript
PostgreSQL MCP Server
DanielRSnell
-
security
F
license
-
quality
Provides read-only access to PostgreSQL databases, enabling LLMs to inspect database schemas and execute read-only SQL queries within a secure transaction context.
Last updated -
16,948
JavaScript
PostgreSQL MCP Server
HenkDz
-
security
A
license
-
quality
A Model Context Protocol server that enables powerful PostgreSQL database management capabilities including analysis, schema management, data migration, and monitoring through natural language interactions.
Last updated -
355
46
TypeScript
AGPL 3.0

View all related MCP servers

PostgreSQL MCP Server