Integrations

Runs as a Node.js application, serving as the execution environment for the MCP server
Provides a secure read-only interface to PostgreSQL databases, allowing execution of validated SELECT queries with timeout protection

Servidor de consultas Postgres MCP

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para consultar una base de datos PostgreSQL en modo de solo lectura, diseñado para funcionar con Claude Desktop y otros clientes MCP.

Descripción general

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona:

Una interfaz segura y de solo lectura para una base de datos PostgreSQL
Integración con Claude Desktop a través del protocolo MCP
Validación de consultas SQL para garantizar que solo se ejecuten consultas SELECT
Protección de tiempo de espera de consulta (10 segundos)

Prerrequisitos

Node.js (v14 o posterior)
npm (viene con Node.js)
Base de datos PostgreSQL (detalles de conexión proporcionados a través de la línea de comandos)

Instalación

# Clone the repository
git clone https://github.com/RathodDarshil/mcp-postgres-query-server.git
cd mcp-postgres-query-server

# Install dependencies
npm install

# Build the project
npm run build

Conexión a Claude Desktop

Puede configurar Claude Desktop para que se inicie y se conecte automáticamente al servidor MCP:

Acceda al archivo de configuración de Claude Desktop:
- Abra Claude Desktop
- Vaya a Configuración > Desarrollador > Editar configuración
- Esto abrirá el archivo de configuración en su editor de texto predeterminado.
Agregue postgres-query-server a la sección mcpServers de su claude_desktop_config.json :

{
    "mcpServers": {
        "postgres-query": {
            "command": "node",
            "args": [
                "/path/to/your/mcp-postgres-query-server/dist/index.js",
                "postgresql://username:password@hostname:port/database"
            ]
        }
    }
}

Reemplace /path/to/your/ con la ruta real al directorio de su proyecto.
Reemplace la cadena de conexión PostgreSQL con sus credenciales de base de datos reales.
Guarde el archivo y reinicie Claude Desktop. El servidor MCP debería aparecer ahora en el menú desplegable de selección de servidores MCP en Configuración.

Ejemplo de configuración

Aquí hay un ejemplo completo de un archivo de configuración con postgres-query:

{
    "mcpServers": {
        "postgres-query": {
            "command": "node",
            "args": [
                "/Users/darshilrathod/mcp-servers/mcp-postgres-query-server/dist/index.js",
                "postgresql://user:password@localhost:5432/mydatabase"
            ]
        }
    }
}

Actualización de la configuración

Para actualizar la configuración de Claude Desktop:

Abra Claude Desktop
Vaya a Configuración > Desarrollador > Editar configuración
Realice sus cambios en el archivo de configuración
Guardar el archivo
Reinicie Claude Desktop para que los cambios surtan efecto.
Si ha actualizado el código del servidor MCP, asegúrese de reconstruirlo con npm run build antes de reiniciar

Características

Acceso a la base de datos de solo lectura : solo se permiten consultas SELECT por motivos de seguridad
Validación de consultas : evita operaciones SQL potencialmente dañinas
Protección de tiempo de espera : las consultas que se ejecutan durante más de 10 segundos se finalizan automáticamente
Compatibilidad con el protocolo MCP : Implementación completa del protocolo de contexto de modelo
Formato de respuesta JSON : los resultados de la consulta se devuelven en formato JSON estructurado

API

Herramientas

consulta-postgres

Ejecuta una consulta SQL de solo lectura en la base de datos PostgreSQL configurada.

Parámetros:

query (cadena): una consulta SQL SELECT para ejecutar

Respuesta:

Objeto JSON que contiene:
- rows : Las filas del conjunto de resultados
- rowCount : Número de filas devueltas
- fields : metadatos de columna

Ejemplo:

query-postgres: SELECT * FROM users LIMIT 5

Desarrollo

La implementación principal del servidor se encuentra en src/index.ts . Componentes clave:

Configuración del grupo de conexiones de PostgreSQL
Lógica de validación de consultas
Configuración del servidor MCP
Definiciones de herramientas y recursos

Para modificar el comportamiento del servidor, puedes:

Editar la lógica de validación de consultas en isReadOnlyQuery()
Agregar herramientas o recursos adicionales al servidor MCP
Modificar la duración del tiempo de espera de la consulta (actualmente 10 segundos)

Consideraciones de seguridad

El servidor valida todas las consultas para garantizar que sean de solo lectura.
La conexión a la base de datos utiliza SSL
El tiempo de espera de la consulta evita el agotamiento de los recursos
No se permiten operaciones de escritura
Las credenciales de la base de datos se pasan directamente a través de argumentos de la línea de comandos, no se almacenan en archivos

Licencia

ISC

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de protocolo de contexto de modelo seguro que permite a Claude ejecutar consultas SQL de solo lectura en una base de datos PostgreSQL, lo que permite la interacción en lenguaje natural con los datos de la base de datos.

PostgreSQL Query MCP Server