Vertica MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
pip install vertica-mcp
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "VERTICA_HOST=${VERTICA_HOST}" -e "VERTICA_USER=${VERTICA_USER}" -e "VERTICA_PASSWORD=${VERTICA_PASSWORD}" -e "VERTICA_DATABASE=${VERTICA_DATABASE}" vertica-mcp -- node "<FULL_PATH_TO_VERTICA_MCP>/dist/index.js"

Replace <FULL_PATH_TO_VERTICA_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:VERTICA_HOSTVERTICA_USERVERTICA_PASSWORDVERTICA_DATABASE
README.md

Transform your Vertica Analytics Database into an AI-powered intelligence layer

Vertica MCP Server

Transform your Vertica Analytics Database into an AI-powered intelligence layer

Quick StartDocumentationFeaturesContributingCommunity


Why Vertica MCP?

The Vertica MCP Server is a production-ready implementation of the Model Context Protocol that transforms your Vertica Analytics Database into an intelligent, AI-accessible data platform. Built with enterprise security and performance in mind, it enables AI assistants like Claude, ChatGPT, and Cursor to directly query, analyze, and optimize your Vertica databases through natural language.

What is MCP?

The Model Context Protocol (MCP) is an open standard developed by Anthropic that provides a universal way for AI assistants to connect with external tools and data sources. Think of it as "USB-C for AI" - a standardized interface that allows any MCP-compatible AI to interact with your systems without custom integrations.

Key Benefits

  • Universal AI Connectivity: Connect any MCP-compatible AI to your Vertica database without custom integrations
  • Enterprise Security: Fine-grained permissions at schema and operation levels with SSL/TLS support
  • High Performance: Connection pooling, query streaming, and automatic pagination for handling massive datasets
  • AI-Optimized: Built-in prompts and tools specifically designed for database analysis and optimization
  • Multiple Transports: Support for STDIO, HTTP, and SSE to fit any deployment scenario
  • Production Ready: Battle-tested with comprehensive error handling, logging, and monitoring

Prerequisites

  • Python 3.11 or higher
  • Vertica Database (accessible instance)
  • uv (Python package manager) - Installation guide
  • Docker (optional, for containerized deployment)
  • Claude Desktop or another MCP-compatible client

Quick Start

Method 1: Local Installation (Development Environment)

This method is recommended when you want to modify the code or work with the development version.

# 1. Clone the repository
git clone https://github.com/zaboura/vertica-mcp.git
cd vertica-mcp

# 2. Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 3. Setup environment and install dependencies
uv sync
source .venv/bin/activate

# 4. Install in development mode
uv pip install -e .

# 5. Configure database connection
cp .env.example .env
# Edit .env with your Vertica credentials

# 6. Run the server
vertica-mcp --transport http --port 8000 --bind-host 0.0.0.0  # HTTP for remote access

Method 2: PyPI Installation (Production Environment)

This method is recommended for production deployments and when you want to use the stable release.

# 1. Install from PyPI
pip install vertica-mcp

# 2. Initialize configuration
vertica-mcp --init

# 3. Edit configuration with your credentials
nano .env  # or use your preferred editor
# Update VERTICA_HOST, VERTICA_USER, VERTICA_PASSWORD, etc.

# 4. Test the installation
vertica-mcp --transport http --port 8000  # For HTTP access
Configuration File

After running vertica-mcp --init, edit the generated .env file with your specific settings:

# Required Database Connec

Tools (3)

queryExecute SQL queries against the Vertica database
list_tablesList all tables in the database schema
get_table_schemaRetrieve column definitions and metadata for a specific table

Environment Variables

VERTICA_HOSTrequiredThe hostname or IP address of the Vertica database
VERTICA_USERrequiredThe username for database authentication
VERTICA_PASSWORDrequiredThe password for database authentication
VERTICA_DATABASErequiredThe name of the Vertica database to connect to

Configuration

claude_desktop_config.json
{"mcpServers": {"vertica": {"command": "vertica-mcp", "env": {"VERTICA_HOST": "localhost", "VERTICA_USER": "dbadmin", "VERTICA_PASSWORD": "password", "VERTICA_DATABASE": "VMart"}}}}

Try it

List all tables in the public schema to understand the database structure.
Show me the schema for the 'sales_data' table.
Write and execute a query to find the top 10 products by revenue from the last month.
Analyze the performance of the current database schema and suggest potential optimizations.

Frequently Asked Questions

What are the key features of Vertica MCP Server?

Direct natural language querying of Vertica databases. Fine-grained permissions at schema and operation levels. Connection pooling and automatic pagination for large datasets. Support for multiple transport protocols including STDIO, HTTP, and SSE. Secure SSL/TLS connection support.

What can I use Vertica MCP Server for?

Enabling data analysts to query massive datasets using natural language via Claude. Automating schema exploration and documentation for database administrators. Integrating Vertica analytics directly into AI-powered development workflows. Building secure, AI-accessible reporting interfaces for enterprise data.

How do I install Vertica MCP Server?

Install Vertica MCP Server by running: pip install vertica-mcp

What MCP clients work with Vertica MCP Server?

Vertica MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Vertica MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare