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: SQLite 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