PostgreSQL Multi-Schema

Proporciona acceso de solo lectura a bases de datos PostgreSQL con soporte para múltiples esquemas, permitiendo a los LLMs inspeccionar esquemas y ejecutar consultas en diferentes espacios de nombres.

Documentación

PostgreSQL Multi-Schema MCP Server

Un servidor de Model Context Protocol que proporciona acceso de solo lectura a bases de datos PostgreSQL con soporte mejorado de múltiples esquemas. Este servidor permite a los LLM inspeccionar esquemas de bases de datos en múltiples espacios de nombres y ejecutar consultas de solo lectura manteniendo el aislamiento de esquemas.

Características principales

  • Soporte de múltiples esquemas: Especifique explícitamente qué esquemas exponer mediante la configuración de línea de comandos
  • Aislamiento de esquemas: Control de acceso estricto solo a los esquemas autorizados listados durante el inicio del servidor
  • Descubrimiento entre esquemas: Vista unificada de tablas en múltiples esquemas manteniendo los límites de esquema
  • Seguridad de metadatos: Filtra los catálogos del sistema para exponer solo tablas definidas por el usuario en los esquemas especificados

Componentes

Herramientas

  • query
    • 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
    • Contexto de esquema mantenido mediante la restricción de search_path

Recursos

El servidor proporciona información de esquema para cada tabla en los esquemas autorizados:

  • Esquemas de tabla (postgres://<host>/<db_schema>/<table>/schema)
    • Información de esquema JSON para cada tabla
    • Incluye nombres de columnas, tipos de datos y modificadores de tipo
    • Descubierto automáticamente a partir de los metadatos de la base de datos
    • Soporte de múltiples esquemas con lista de permitidos de esquemas explícita

Uso

El servidor requiere una URL de base de datos y acepta una lista separada por comas de esquemas a exponer:

npx -y mcp-server-postgres-multi-schema <database-url> [schemas]
  • database-url: Cadena de conexión de PostgreSQL (por ejemplo, postgresql://localhost/mydb)
  • schemas: Lista separada por comas de esquemas a exponer (por defecto 'public' si no se especifica)

Ejemplos

# Connect with default public schema
npx -y mcp-server-postgres-multi-schema postgresql://localhost/mydb

# Connect with multiple schemas
npx -y mcp-server-postgres-multi-schema postgresql://localhost/mydb public,analytics,staging

Uso con Claude Desktop

Configure la sección "mcpServers" en su claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-postgres-multi-schema",
        "postgresql://localhost/mydb",
        "public,audit"
      ]
    }
  }
}

Licencia

Este servidor MCP de múltiples esquemas está licenciado bajo la Licencia MIT. Puede usar, modificar y distribuir el software de acuerdo con los términos del archivo LICENSE.