# nolleh
## 基本信息
- Slug: `nolleh-mcp-vertica`
- Source: modelscope
- Publisher: @nolleh/mcp-vertica
- Categories: databases / data-platforms / rag-systems
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@nolleh/mcp-vertica
## 简介
暂无描述。
## MCP Server 详情

[![MseeP.ai 安全评估徽章](https://mseep.net/pr/nolleh-mcp-vertica-badge.png)](https://mseep.ai/app/nolleh-mcp-vertica)

# MCP Vertica
[![smithery 徽章](https://smithery.ai/badge/@nolleh/mcp-vertica)](https://smithery.ai/server/@nolleh/mcp-vertica)

一个 Vertica MCP（模型-上下文-协议）服务器

### 示例：MCP 服务器设置

创建或编辑您的 MCP 客户端配置文件，内容如下：

json
{
  "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 支持
- 日志中的密码掩码

## 工具

### 数据库操作

1. `execute_query`
   - 执行 SQL 查询
   - 支持所有 SQL 操作

2. `stream_query`
   - 分批流式传输大量查询结果
   - 可配置的批次大小

3. `copy_data`
   - 使用 COPY 命令批量加载数据
   - 适用于大数据集

### 模式管理

1. `get_table_structure`
   - 获取详细的表结构
   - 列信息
   - 约束

2. `list_indexes`
   - 列出表的所有索引
   - 索引类型和唯一性
   - 列信息

3. `list_views`
   - 列出模式中的所有视图
   - 视图定义

## 配置

### 环境变量

env
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


### 操作权限

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


### 模式权限

env
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


## 安装

### 通过 Smithery 安装

要通过 [Smithery](https://smithery.ai/server/@nolleh/mcp-vertica) 自动安装 Claude Desktop 的 Vertica 数据库连接器：

bash
npx -y @smithery/cli install @nolleh/mcp-vertica --client claude


### 手动安装
bash
uvx mcp-vertica


## 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

## 在 Docker 环境中运行

当使用 Docker Compose 运行 Vertica 时，可以按以下方式运行 MCP 服务器：

### 1. 使用直接参数运行

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


### 2. 使用环境变量运行

创建一个包含以下内容的 `.env` 文件：

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 文件运行

bash
uvx mcp-vertica 
  --env-file .env


### 测试用例：VerticaDB Docker Compose 示例

yaml
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请提供需要翻译的英文技术文档内容，以便我进行翻译。