Skip to main content
Glama
MCP Vertica
by nolleh

MCP 버티카

Vertica MCP(모델-컨텍스트-프로토콜) 서버

예: MCP 서버 설정

다음 내용으로 mcp 클라이언트 구성 파일을 만들거나 편집하세요.

지엑스피1

[!메모]

  • --ssl 또는 --ssl-reject-unauthorized 와 같은 부울 플래그의 경우, 플래그를 추가(예: "--ssl" )하면 활성화되고, 생략하면 비활성화됩니다.

  • 빈 비밀번호의 경우 위에 표시된 대로 빈 문자열을 사용하세요.

특징

데이터베이스 연결 관리

  • 구성 가능한 제한이 있는 연결 풀링

  • SSL/TLS 지원

  • 자동 연결 정리

  • 연결 시간 초과 처리

쿼리 작업

  • SQL 쿼리 실행

  • 대량의 쿼리 결과를 일괄적으로 스트리밍합니다.

  • 데이터 복사 작업

  • 거래 관리

스키마 관리

  • 테이블 구조 검사

  • 인덱스 관리

  • 뷰 관리

  • 제약 정보

  • 열 세부 정보

보안 기능

  • 작업 수준 권한(INSERT, UPDATE, DELETE, DDL)

  • 스키마별 권한

  • SSL/TLS 지원

  • 로그의 비밀번호 마스킹

Related MCP server: MSSQL 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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

Docker 환경에서 실행

Docker Compose와 함께 Vertica를 실행하는 경우 다음과 같이 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

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
      -