МКП Вертика

Сервер Vertica MCP (модель-контекст-протокол)

Пример: настройка сервера MCP

Создайте или отредактируйте файл конфигурации клиента mcp со следующим содержимым:

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

[!Примечание]

• Для логических флагов, таких как --ssl или --ssl-reject-unauthorized , просто добавьте флаг (например, "--ssl" ), чтобы включить его, или опустите его, чтобы отключить.

• Для пустого пароля используйте пустую строку, как показано выше.

Функции

Управление подключением к базе данных

• Объединение подключений с настраиваемыми ограничениями

• Поддержка SSL/TLS

• Автоматическая очистка соединения

• Обработка тайм-аута соединения

Операции запроса

• Выполнение SQL-запросов

• Передавайте большие результаты запросов пакетами

• Операции копирования данных

• Управление транзакциями

Управление схемой

• Проверка структуры таблицы

• Управление индексом

• Посмотреть управление

• Информация об ограничениях

• Подробности столбца

Функции безопасности

• Разрешения на уровне операций (INSERT, UPDATE, DELETE, DDL)

• Разрешения, специфичные для схемы

• Поддержка SSL/TLS

• Маскировка пароля в журналах

Related MCP server: SQLite MCP Server

Инструменты

Операции с базами данных

1. execute_query

   • Выполнение SQL-запросов

   • Поддержка всех операций SQL

2. stream_query

   • Передавайте большие результаты запросов пакетами

   • Настраиваемый размер партии

3. copy_data

   • Массовая загрузка данных с помощью команды COPY

   • Эффективно для больших наборов данных

Управление схемой

1. get_table_structure

   • Получить подробную структуру таблицы

   • Информация о столбце

   • Ограничения

2. list_indexes

   • Список всех индексов для таблицы

   • Тип индекса и уникальность

   • Информация о столбце

3. list_views

   • Перечислить все представления в схеме

   • Посмотреть определения

Конфигурация

Переменные среды

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

Разрешения на операции

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

Разрешения схемы

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

Установка

uvx mcp-vertica

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Работа в среде Docker

При запуске Vertica с Docker Compose вы можете запустить сервер MCP следующим образом:

1. Запуск с прямыми параметрами

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

2. Запуск с переменными среды

Создайте файл .env со следующим содержимым:

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

Затем запустите с .env

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

Для тестирования, пример VerticaDB Docker Compose

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