PostgreSQL Multi-Schema

Servidor MCP PostgreSQL Multi-Schema

Um servidor Model Context Protocol que fornece acesso somente leitura a bancos de dados PostgreSQL com suporte aprimorado a múltiplos esquemas. Este servidor permite que LLMs inspecionem esquemas de banco de dados em vários namespaces e executem consultas somente leitura, mantendo o isolamento de esquemas.

Principais Recursos

• Suporte a Múltiplos Esquemas: Especifique explicitamente quais esquemas expor por meio da configuração de linha de comando
• Isolamento de Esquemas: Controle de acesso estrito apenas aos esquemas autorizados listados durante a inicialização do servidor
• Descoberta entre Esquemas: Visão unificada das tabelas em vários esquemas, mantendo os limites de esquema
• Segurança de Metadados: Filtra catálogos do sistema para expor apenas tabelas definidas pelo usuário nos esquemas especificados

Componentes

Ferramentas

• query
  • Executa consultas SQL somente leitura no banco de dados conectado
  • Entrada: sql (string): A consulta SQL a ser executada
  • Todas as consultas são executadas em uma transação SOMENTE LEITURA
  • Contexto de esquema mantido por meio da restrição de search_path

Recursos

O servidor fornece informações de esquema para cada tabela nos esquemas autorizados:

• Esquemas de Tabela (postgres://<host>/<db_schema>/<table>/schema)
  • Informações de esquema JSON para cada tabela
  • Inclui nomes de colunas, tipos de dados e modificadores de tipo
  • Descobertos automaticamente a partir dos metadados do banco de dados
  • Suporte a múltiplos esquemas com lista de permissão de esquemas explícita

Uso

O servidor requer uma URL de banco de dados e aceita uma lista separada por vírgulas de esquemas a expor:

npx -y mcp-server-postgres-multi-schema <database-url> [schemas]

• database-url: String de conexão PostgreSQL (ex.: postgresql://localhost/mydb)
• schemas: Lista separada por vírgulas de esquemas a expor (padrão: 'public' se não especificado)

Exemplos

# 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 com Claude Desktop

Configure a seção "mcpServers" no seu claude_desktop_config.json:

NPX

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

Licença

Este servidor MCP multi-esquema é licenciado sob a Licença MIT. Você pode usar, modificar e distribuir o software de acordo com os termos do arquivo LICENSE.