MCP Vertica

Ein Vertica MCP (Model-Context-Protocol)-Server

Beispiel: MCP-Servereinstellung

Erstellen oder bearbeiten Sie die Datei „Ihre MCP-Client-Konfigurationsdatei“ mit dem folgenden Inhalt:

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

[!Notiz]

• Fügen Sie für boolesche Flags wie --ssl oder --ssl-reject-unauthorized einfach das Flag hinzu (z. B. "--ssl" ), um es zu aktivieren, oder lassen Sie es weg, um es zu deaktivieren.

• Verwenden Sie für ein leeres Passwort eine leere Zeichenfolge, wie oben gezeigt.

Merkmale

Datenbankverbindungsverwaltung

• Verbindungspooling mit konfigurierbaren Limits

• SSL/TLS-Unterstützung

• Automatische Verbindungsbereinigung

• Handhabung von Verbindungstimeouts

Abfragevorgänge

• Ausführen von SQL-Abfragen

• Streamen großer Abfrageergebnisse in Batches

• Datenkopiervorgänge

• Transaktionsmanagement

Schemaverwaltung

• Überprüfung der Tabellenstruktur

• Indexverwaltung

• Ansichtsverwaltung

• Einschränkungsinformationen

• Spaltendetails

Sicherheitsfunktionen

• Berechtigungen auf Operationsebene (INSERT, UPDATE, DELETE, DDL)

• Schemaspezifische Berechtigungen

• SSL/TLS-Unterstützung

• Kennwortmaskierung in Protokollen

Related MCP server: SQLite MCP Server

Werkzeuge

Datenbankoperationen

1. execute_query

   • Ausführen von SQL-Abfragen

   • Unterstützung für alle SQL-Operationen

2. stream_query

   • Streamen großer Abfrageergebnisse in Batches

   • Konfigurierbare Batchgröße

3. copy_data

   • Massenladen von Daten mit dem Befehl COPY

   • Effizient für große Datensätze

Schemaverwaltung

1. get_table_structure

   • Erhalten Sie eine detaillierte Tabellenstruktur

   • Spalteninformationen

   • Einschränkungen

2. list_indexes

   • Alle Indizes für eine Tabelle auflisten

   • Indextyp und Eindeutigkeit

   • Spalteninformationen

3. list_views

   • Auflisten aller Ansichten in einem Schema

   • Definitionen anzeigen

Konfiguration

Umgebungsvariablen

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

Betriebsberechtigungen

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

Schemaberechtigungen

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

Installation

uvx mcp-vertica

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

Ausführung in einer Docker-Umgebung

Wenn Sie Vertica mit Docker Compose ausführen, können Sie den MCP-Server wie folgt ausführen:

1. Ausführen mit direkten Parametern

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

2. Ausführen mit Umgebungsvariablen

Erstellen Sie eine .env -Datei mit folgendem Inhalt:

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

Führen Sie dann mit .env aus

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

Zum Testen: VerticaDB Docker Compose-Beispiel

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