PostgreSQL

Un servidor de Protocolo de Contexto de Modelo que proporciona acceso de solo lectura a bases de datos PostgreSQL. Este servidor permite a los LLM inspeccionar esquemas de bases de datos y ejecutar consultas de solo lectura.

Componentes

Herramientas

consulta
- Ejecutar consultas SQL de solo lectura contra la base de datos conectada
- Entrada: sql (cadena): La consulta SQL a ejecutar
- Todas las consultas se ejecutan dentro de una transacción de SOLO LECTURA

Recursos

El servidor proporciona información de esquema para cada tabla de la base de datos:

Esquemas de tabla ( postgres://<host>/<table>/schema )
- Información del esquema JSON para cada tabla
- Incluye nombres de columnas y tipos de datos.
- Descubierto automáticamente a partir de metadatos de la base de datos

Related MCP server: PostgreSQL Multi-Schema MCP Server

Configuración

Uso con Claude Desktop

Para usar este servidor con la aplicación Claude Desktop, agregue la siguiente configuración a la sección "mcpServers" de su claude_desktop_config.json :

Estibador

Al ejecutar Docker en macOS, use host.docker.internal si el servidor se ejecuta en la red del host (por ejemplo, localhost).
El nombre de usuario y la contraseña se pueden agregar a la URL de postgresql con postgresql://user:password@host:port/db-name

{ "mcpServers": { "postgres": { "command": "docker", "args": [ "run", "-i", "--rm", "mcp/postgres", "postgresql://host.docker.internal:5432/mydb"] } } }

NPX

{ "mcpServers": { "postgres": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb" ] } } }

Reemplace /mydb con el nombre de su base de datos.

Uso con VS Code

Para una instalación rápida, utilice uno de los botones de instalación de un solo clic que aparecen a continuación...

Instalar con NPX en VS Code Instalar con NPX en VS Code Insiders

Instalar con Docker en VS Code

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Para ello, presione Ctrl + Shift + P y escriba Preferences: Open User Settings (JSON) .

Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otros.

Tenga en cuenta que la clave mcp no es necesaria en el archivo .vscode/mcp.json .

Estibador

Nota : cuando use Docker y se conecte a un servidor PostgreSQL en su máquina host, use host.docker.internal en lugar de localhost en la URL de conexión.

{ "mcp": { "inputs": [ { "type": "promptString", "id": "pg_url", "description": "PostgreSQL URL (e.g. postgresql://user:pass@host.docker.internal:5432/mydb)" } ], "servers": { "postgres": { "command": "docker", "args": [ "run", "-i", "--rm", "mcp/postgres", "${input:pg_url}" ] } } } }

NPX

{ "mcp": { "inputs": [ { "type": "promptString", "id": "pg_url", "description": "PostgreSQL URL (e.g. postgresql://user:pass@localhost:5432/mydb)" } ], "servers": { "postgres": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-postgres", "${input:pg_url}" ] } } } }

Edificio

Estibador:

docker build -t mcp/postgres -f src/postgres/Dockerfile .

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.