Servidor MCP de PostgreSQL

Un servidor MCP (Model Context Protocol) que se conecta a una base de datos PostgreSQL local, permitiendo a los asistentes de IA consultar y gestionar su base de datos.

Herramientas proporcionadas

Related MCP server: PostgreSQL MCP Server

Recursos

• schema-overview (postgres://schema/overview) — Resumen completo del esquema de la base de datos en Markdown

Conexión dinámica mediante cabeceras

Este servidor admite conexiones dinámicas a PostgreSQL. Puede proporcionar las credenciales de la base de datos a través de cabeceras HTTP en la solicitud inicial de conexión SSE. Esto permite que una única instancia desplegada del servidor sirva a múltiples bases de datos diferentes.

Cabeceras admitidas

Configuración en Antigravity / Cursor (VS Code)

Para usar este servidor con Antigravity o Cursor, añada lo siguiente a su mcp_config.json (normalmente ubicado en %APPDATA%\antigravity\ o en la configuración MCP de su IDE):

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://postgree-mcp-dfadduf9bsdvdwa9.eastasia-01.azurewebsites.net/sse",
        "--header", "x-pg-host: pg-168600c0-aeiyankhan2-d42e.g.aivencloud.com",
        "--header", "x-pg-port: 26768",
        "--header", "x-pg-user: avnadmin",
        "--header", "x-pg-password: YOUR_PASSWORD",
        "--header", "x-pg-database: defaultdb",
        "--header", "x-pg-ssl: true"
      ]
    }
  }
}

Configuración en Claude Code CLI

Si utiliza la Claude Code CLI, puede añadir este servidor usando el siguiente comando:

1. Instalar Claude Code (si no está instalado)

npm install -g @anthropic-ai/claude-code

2. Añadir el servidor MCP de PostgreSQL

Ejecute este comando en su terminal:

claude mcp add postgres -- npx mcp-remote https://postgree-mcp-dfadduf9bsdvdwa9.eastasia-01.azurewebsites.net/sse \
  --header "x-pg-host: pg-168600c0-aeiyankhan2-d42e.g.aivencloud.com" \
  --header "x-pg-port: 26768" \
  --header "x-pg-user: avnadmin" \
  --header "x-pg-password: YOUR_PASSWORD" \
  --header "x-pg-database: defaultdb" \
  --header "x-pg-ssl: true"

Configuración en Claude Desktop

Añada esto a su claude_desktop_config.json:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://postgree-mcp-dfadduf9bsdvdwa9.eastasia-01.azurewebsites.net/sse",
        "--header", "x-pg-host: pg-168600c0-aeiyankhan2-d42e.g.aivencloud.com",
        "--header", "x-pg-port: 26768",
        "--header", "x-pg-user: avnadmin",
        "--header", "x-pg-password: YOUR_PASSWORD",
        "--header", "x-pg-database: defaultdb",
        "--header", "x-pg-ssl: true"
      ]
    }
  }
}

Configuración local (para desarrollo)

1. Instalar dependencias

npm install

2. Configurar la base de datos predeterminada (opcional)

Todavía puede usar un archivo .env para el desarrollo local:

PG_HOST=localhost
PG_PORT=5432
PG_USER=postgres
PG_PASSWORD=your_password_here
PG_DATABASE=your_database_name

3. Compilar y ejecutar

npm run build
npm start

Ejemplos de uso

Una vez configurado, puede pedirle al asistente de IA cosas como:

• "List all tables in my database"

• "Describe the users table"

• "SELECT * FROM orders WHERE created_at > '2025-01-01'"

• "Create a new table called products"