Skip to main content
Glama
MCP Vertica
by nolleh

MCP Vertical

Un servidor MCP (modelo-contexto-protocolo) de Vertica

Ejemplo: Configuración del servidor MCP

Cree o edite el archivo de configuración de su cliente mcp con el siguiente contenido:

{
  "mcpServers": {
    "vertica": {
      "command": "uvx",
      "args": [
        "mcp-vertica",
        "--host=localhost",
        "--db-port=5433",
        "--database=VMart",
        "--user=dbadmin",
        "--password=",
        "--connection-limit=10"
      ]
    }
  }
}

[!Nota]

  • Para indicadores booleanos como --ssl o --ssl-reject-unauthorized , simplemente agregue el indicador (por ejemplo, "--ssl" ) para habilitarlo u omítalo para deshabilitarlo.

  • Para una contraseña vacía, utilice una cadena vacía como se muestra arriba.

Características

Gestión de la conexión a bases de datos

  • Agrupación de conexiones con límites configurables

  • Compatibilidad con SSL/TLS

  • Limpieza automática de la conexión

  • Manejo del tiempo de espera de conexión

Operaciones de consulta

  • Ejecutar consultas SQL

  • Transmitir resultados de consultas grandes en lotes

  • Operaciones de copia de datos

  • Gestión de transacciones

Gestión de esquemas

  • Inspección de la estructura de la mesa

  • Gestión de índices

  • Gestión de vistas

  • Información de restricciones

  • Detalles de la columna

Características de seguridad

  • Permisos a nivel de operación (INSERTAR, ACTUALIZAR, ELIMINAR, DDL)

  • Permisos específicos del esquema

  • Compatibilidad con SSL/TLS

  • Enmascaramiento de contraseñas en los registros

Related MCP server: MSSQL MCP Server

Herramientas

Operaciones de base de datos

  1. execute_query

    • Ejecutar consultas SQL

    • Soporte para todas las operaciones SQL

  2. stream_query

    • Transmitir resultados de consultas grandes en lotes

    • Tamaño de lote configurable

  3. copy_data

    • Carga masiva de datos mediante el comando COPY

    • Eficiente para grandes conjuntos de datos

Gestión de esquemas

  1. get_table_structure

    • Obtenga la estructura detallada de la tabla

    • Información de la columna

    • Restricciones

  2. list_indexes

    • Listar todos los índices de una tabla

    • Tipo de índice y unicidad

    • Información de la columna

  3. list_views

    • Enumerar todas las vistas en un esquema

    • Ver definiciones

Configuración

Variables de entorno

VERTICA_HOST=localhost
VERTICA_PORT=5433
VERTICA_DATABASE=VMart
VERTICA_USER=newdbadmin
VERTICA_PASSWORD=vertica
VERTICA_CONNECTION_LIMIT=10
VERTICA_SSL=false
VERTICA_SSL_REJECT_UNAUTHORIZED=true

Permisos de operación

ALLOW_INSERT_OPERATION=false
ALLOW_UPDATE_OPERATION=false
ALLOW_DELETE_OPERATION=false
ALLOW_DDL_OPERATION=false

Permisos de esquema

SCHEMA_INSERT_PERMISSIONS=schema1:true,schema2:false
SCHEMA_UPDATE_PERMISSIONS=schema1:true,schema2:false
SCHEMA_DELETE_PERMISSIONS=schema1:true,schema2:false
SCHEMA_DDL_PERMISSIONS=schema1:true,schema2:false

Instalación

uvx mcp-vertica

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Ejecución en el entorno Docker

Al ejecutar Vertica con Docker Compose, puede ejecutar el servidor MCP de la siguiente manera:

1. Ejecutar con parámetros directos

uvx mcp-vertica \
  --host localhost \
  --db-port 5433 \
  --database VMart \
  --user dbadmin \
  --password "" \
  --connection-limit 10

2. Ejecutar con variables de entorno

Crea un archivo .env con el siguiente contenido:

VERTICA_HOST=localhost
VERTICA_PORT=5433
VERTICA_DATABASE=test_db
VERTICA_USER=test_user
VERTICA_PASSWORD=test_password
VERTICA_CONNECTION_LIMIT=10
VERTICA_SSL=false
VERTICA_SSL_REJECT_UNAUTHORIZED=true

Luego ejecuta con .env

uvx mcp-vertica \
  --env-file .env

Para pruebas, ejemplo de Docker Compose de VerticaDB

version: "3.8"

services:
  vertica:
    # image: vertica/vertica-ce:11.1.0-0
    image: vertica/vertica-ce:latest
    platform: linux/amd64
    container_name: vertica-ce
    environment:
      VERTICA_MEMDEBUG: 2
    ports:
      - "5433:5433"
      - "5444:5444"
    volumes:
      - vertica_data:/home/dbadmin/VMart
    healthcheck:
      test:
        [
          "CMD",
          "/opt/vertica/bin/vsql",
          "-h",
          "localhost",
          "-d",
          "VMart",
          "-U",
          "dbadmin",
          "-c",
          "SELECT 1",
        ]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    restart: unless-stopped

volumes:
  vertica_data:
    driver: local

Available Tools

6 tools
copy_dataC

Copy data into a Vertica table using COPY command.

Args:
    ctx: FastMCP context for progress reporting and logging
    schema: vertica schema to execute the copy against
    table: Target table name
    data: List of rows to insert

Returns:
    Status message indicating success or failure

Inputs: schema (required), table (required), data (required).

execute_queryC

Execute a SQL query and return the results.

Args:
    ctx: FastMCP context for progress reporting and logging
    query: SQL query to execute
    database: Optional database name to execute the query against

Returns:
    Query results as a string

Inputs: query (required).

get_table_structureB

Get the structure of a table including columns, data types, and constraints.

Args:
    ctx: FastMCP context for progress reporting and logging
    table_name: Name of the table to inspect
    schema: Schema name (default: public)

Returns:
    Table structure information as a string

Inputs: table_name (required), schema.

list_indexesB

List all indexes for a specific table.

Args:
    ctx: FastMCP context for progress reporting and logging
    table_name: Name of the table to inspect
    schema: Schema name (default: public)

Returns:
    Index information as a string

Inputs: table_name (required), schema.

list_viewsB

List all views in a schema.

Args:
    ctx: FastMCP context for progress reporting and logging
    schema: Schema name (default: public)

Returns:
    View information as a string

Inputs: schema.

stream_queryC

Execute a SQL query and return the results in batches as a single string.

Args:
    ctx: FastMCP context for progress reporting and logging
    query: SQL query to execute
    batch_size: Number of rows to fetch at once

Returns:
    Query results as a concatenated string

Inputs: query (required), batch_size.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 6 tools

    Disambiguation3/5

    Most tools are distinct, but 'execute_query' and 'stream_query' both execute SQL queries with only a difference in batch handling, leading to potential confusion for an agent.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with underscores (e.g., copy_data, list_indexes, get_table_structure), making the naming predictable.

    Tool Count4/5

    6 tools is a reasonable size for a focused database server, though it leans slightly low.

    Completeness2/5

    The set covers query execution and data copying but lacks essential operations like table creation, modification, and deletion, leaving significant gaps for typical database management.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables SQL query execution, database management, and business intelligence capabilities through MySQL connections.
      1,462 npm
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables executing SQL queries and managing connections with Microsoft SQL Server databases.
      1
      2,101 npm
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides AI assistants with comprehensive access to SQL databases, enabling schema inspection, query execution, and database operations with enterprise-grade security.
      62 npm
      9
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants to interact with Vertica databases through SQL queries, schema inspection, database documentation, and data export capabilities.
      1
      -