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 Start • Documentation • Features • Contributing • Community
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 databaselist_tablesList all tables in the database schemaget_table_schemaRetrieve column definitions and metadata for a specific tableEnvironment Variables
VERTICA_HOSTrequiredThe hostname or IP address of the Vertica databaseVERTICA_USERrequiredThe username for database authenticationVERTICA_PASSWORDrequiredThe password for database authenticationVERTICA_DATABASErequiredThe name of the Vertica database to connect toConfiguration
{"mcpServers": {"vertica": {"command": "vertica-mcp", "env": {"VERTICA_HOST": "localhost", "VERTICA_USER": "dbadmin", "VERTICA_PASSWORD": "password", "VERTICA_DATABASE": "VMart"}}}}