-
securityF
license-
qualityA Model Context Protocol server providing both read and write access to PostgreSQL databases, enabling LLMs to query data, modify records, and manage database schemas.
Last updated -
583
7
Servidor MCP para PostgreSQL
Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) para PostgreSQL, que proporciona una interfaz simple para interactuar con bases de datos PostgreSQL a través de MCP.
Características
Ejecutar consultas SQL con entradas parametrizadas
Ejecutar operaciones INSERTAR/ACTUALIZAR/ELIMINAR
Crear nuevas bases de datos
Crear o actualizar esquemas de tablas
Depurar conexiones PostgreSQL
En contenedores con Docker para una fácil implementación
Configuración basada en el entorno
Prerrequisitos
Python 3.8+
PostgreSQL 10+
Docker (opcional, para implementación en contenedores)
Docker Compose (opcional, para desarrollo)
Instalación
Uso de Docker (recomendado)
Clonar el repositorio:
git clone https://github.com/asadudin/mcp-server-postgres.git cd mcp-server-postgresCopie el archivo de entorno de ejemplo:
cp .env.example .envActualice el archivo
.envcon sus credenciales de PostgreSQL:PG_HOST=postgres PG_PORT=5432 PG_USER=postgres PG_PASSWORD=your_password PG_DATABASE=your_database HOST=0.0.0.0 PORT=8056Inicie el servicio usando Docker Compose:
docker-compose up -d
Instalación manual
Clonar el repositorio:
git clone https://github.com/asadudin/mcp-server-postgres.git cd mcp-server-postgresCrear y activar un entorno virtual:
python -m venv venv source venv/bin/activate # On Windows: .\venv\Scripts\activateInstalar dependencias:
pip install -r requirements.txtCopie el archivo de entorno de ejemplo y actualícelo:
cp .env.example .env # Edit .env with your configurationEjecutar el servidor:
python mcp_server_postgres.py
Uso
El servidor MCP proporciona los siguientes puntos finales:
sql_query
Ejecute una consulta SELECT y devuelva los resultados como JSON.
Parámetros:
query: cadena de consulta SQLparams: cadena JSON opcional de parámetros de consulta (lista o diccionario)
Ejemplo:
{
"query": "SELECT * FROM users WHERE id = $1",
"params": [1]
}
sql_execute
Ejecutar una instrucción INSERT/UPDATE/DELETE.
Parámetros:
query: instrucción SQLparams: cadena JSON opcional de parámetros de consulta (lista o diccionario)
Ejemplo:
{
"query": "INSERT INTO users (name, email) VALUES ($1, $2)",
"params": ["John Doe", "john@example.com"]
}
create_database
Crear una nueva base de datos PostgreSQL.
Parámetros:
database_name: Nombre de la base de datos a crear
create_or_update_table
Crear o actualizar un esquema de tabla.
Parámetros:
sql: instrucción SQL CREATE TABLE o ALTER TABLE
debug_postgres_connection
Depurar la conexión PostgreSQL.
Variables de entorno
Variable | Por defecto | Descripción |
PG_HOST | host local | Host de PostgreSQL |
PUERTO_PG | 5432 | Puerto PostgreSQL |
PG_USER | postgres | Nombre de usuario de PostgreSQL |
CONTRASEÑA PG | Contraseña de PostgreSQL | |
BASE DE DATOS PG | postgres | Nombre de la base de datos predeterminada |
ANFITRIÓN | 0.0.0.0 | Host al que vincular el servidor MCP |
PUERTO | 8056 | Puerto para ejecutar el servidor MCP |
Desarrollo
Ejecución de pruebas
# Install test dependencies
pip install -r requirements-dev.txt
# Run tests
pytest
Construyendo la imagen de Docker
docker build -t mcp-server-postgres .
Documentación de la API
Para obtener documentación detallada de la API, consulte la especificación OpenAPI .
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
Expresiones de gratitud
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Una implementación de servidor de Protocolo de Contexto de Modelo que proporciona una interfaz simple para interactuar con bases de datos PostgreSQL, permitiendo consultas SQL, operaciones de base de datos y administración de esquemas a través de MCP.
Related MCP Servers
- AsecurityAlicenseAqualityA 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 -181,016119AGPL 3.0
- -securityFlicense-qualityA Model Context Protocol server that enables performing PostgreSQL database operations (create, read, update, delete) on User and Post entities through MCP tools.Last updated -
- -securityAlicense-qualityA Model Context Protocol server that enables interaction with PostgreSQL databases to list tables, retrieve schemas, and execute read-only SQL queries.Last updated -26MIT License