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