-
securityA
license-
qualityA Model Context Protocol server that enables Claude to execute SQL queries on Snowflake databases with automatic connection lifecycle management.
Last updated -
43
MIT License
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
mcpServersde suclaude_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 buildantes 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 resultadosrowCount: Número de filas devueltasfields: 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.
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
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.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that provides read-only access to PostgreSQL databases, enabling LLMs to inspect database schemas and execute read-only queries.Last updated -21,552
- -securityFlicense-qualityA Model Context Protocol server that allows Large Language Models like Claude to execute SQL queries, explore database schemas, and maintain persistent connections to SQL Server databases.Last updated -
- AsecurityAlicenseAqualityA Model Context Protocol server that enables Claude to access and interact with Oracle databases through natural language queries.Last updated -3MIT License