mcp/redshift-mcp-server

用于Amazon Redshift数据仓库的操作和查询工具，提供集群、数据库、模式、表和列的列表功能以及SQL查询执行能力，支持元数据发现和数据查询处理。

0 次下载activemcp

Amazon Redshift MCP Server

镜像概述和主要用途

Amazon Redshift MCP Server是由awslabs开发的Docker镜像，用于Amazon Redshift数据仓库的操作和查询。该镜像提供了一系列工具，支持集群管理、数据库/模式/表/列的元数据发现以及SQL查询执行，帮助用户高效管理和查询Redshift数据仓库资源。

MCP信息

属性	详情
Docker镜像	mcp/redshift-mcp-server
作者	awslabs
代码仓库	[***]

镜像构建信息

属性	详情
Dockerfile	[***]
构建方	Docker Inc.
Docker Scout健康评分	!Docker Scout Health Score
验证签名	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/redshift-mcp-server --key [***]`
许可证	Apache License 2.0

核心功能和特性

可用工具（6个）

工具名称	简短描述
`execute_query`	对Redshift集群或无服务器工作组执行SQL查询。
`list_clusters`	列出所有可用的Amazon Redshift集群和无服务器工作组。
`list_columns`	列出Redshift模式中指定表的所有列。
`list_databases`	列出指定Amazon Redshift集群中的所有数据库。
`list_schemas`	列出Redshift数据库中指定数据库的所有模式。
`list_tables`	列出Redshift数据库中指定模式的所有表。

工具详细说明

`execute_query`

对Redshift集群或无服务器工作组执行SQL查询。该工具使用Redshift Data API执行SQL查询并返回结果，支持预置集群和无服务器工作组，处理多种数据类型的结果集。

使用要求

AWS凭证已正确配置（通过AWS_PROFILE或默认凭证）
集群必须可用且可访问
所需IAM权限：redshift-data:ExecuteStatement, redshift-data:DescribeStatement, redshift-data:GetStatementResult
用户必须具有在指定数据库中执行查询的适当权限

参数

参数	类型	描述
`cluster_identifier`	`string`	执行查询的集群标识符，必须是`list_clusters`工具返回的有效标识符。
`database_name`	`string`	执行查询的数据库名称，必须是`list_databases`工具返回的有效名称。
`sql`	`string`	要执行的SQL语句，应为单个SQL语句。

响应结构

返回包含以下结构的QueryResult对象：

columns: 结果集中的列名列表
rows: 行列表，每行是一个值列表
row_count: 返回的行数
execution_time_ms: 查询执行时间（毫秒）
query_id: 查询执行的唯一标识符

数据类型处理

自动处理多种Redshift数据类型：

字符串值（VARCHAR、CHAR、TEXT）
数值（INTEGER、BIGINT、DECIMAL、FLOAT）
布尔值
NULL值
日期和时间戳值（以字符串形式返回）

`list_clusters`

列出AWS账户中所有可用的Amazon Redshift集群和无服务器工作组，返回集群状态、连接详情和配置信息。

使用要求

AWS凭证已正确配置
所需IAM权限：redshift:DescribeClusters, redshift-serverless:ListWorkgroups, redshift-serverless:GetWorkgroup

响应结构

返回RedshiftCluster对象列表，包含：

identifier: 集群/工作组的唯一标识符
type: 集群类型（provisioned或serverless）
status: 集群当前状态
database_name: 默认数据库名称
endpoint: 连接端点信息
port: 连接端口
vpc_id: 集群所在的VPC ID
node_type: 节点类型（适用于预置集群）
number_of_nodes: 节点数量（适用于预置集群）
creation_time: 集群创建时间
master_username: 集群主用户名
publicly_accessible: 集群是否可公开访问
encrypted: 集群是否加密
tags: 与集群关联的标签

`list_columns`

列出Redshift模式中指定表的所有列，查询SVV_ALL_COLUMNS系统视图以发现用户有权访问的列信息，包括数据类型、约束和列属性。

使用要求

AWS凭证已正确配置
集群必须可用且可访问
所需IAM权限：redshift-data:ExecuteStatement, redshift-data:DescribeStatement, redshift-data:GetStatementResult
用户必须有权访问数据库以查询系统视图

参数

参数	类型	描述
`cluster_identifier`	`string`	查询列的集群标识符，必须是`list_clusters`工具返回的有效标识符。
`column_database_name`	`string`	列出列的数据库名称，必须是`list_databases`工具返回的有效名称。
`column_schema_name`	`string`	列出列的模式名称，必须是`list_schemas`工具返回的有效名称。
`column_table_name`	`string`	列出列的表名称，必须是`list_tables`工具返回的有效名称。

响应结构

返回RedshiftColumn对象列表，包含：

database_name: 数据库名称
schema_name: 模式名称
table_name: 表名称
column_name: 列名称
ordinal_position: 列在表中的位置
column_default: 列的默认值
is_nullable: 列是否可为空（yes或no）
data_type: 列的数据类型
character_maximum_length: 列的最大字符长度
numeric_precision: 数值精度
numeric_scale: 数值小数位数
remarks: 列的备注信息

`list_databases`

列出指定Amazon Redshift集群中的所有数据库，查询SVV_REDSHIFT_DATABASES系统视图以发现用户有权访问的数据库，包括本地数据库和来自数据共享的数据库。

使用要求

AWS凭证已正确配置
集群必须可用且可访问
所需IAM权限：redshift-data:ExecuteStatement, redshift-data:DescribeStatement, redshift-data:GetStatementResult
用户必须有权访问指定数据库以查询系统视图

参数

参数	类型	描述
`cluster_identifier`	`string`	查询数据库的集群标识符，必须是`list_clusters`工具返回的有效标识符。
`database_name`	`string` 可选	用于查询系统视图的连接数据库，默认为"dev"。

响应结构

返回RedshiftDatabase对象列表，包含：

database_name: 数据库名称
database_owner: 数据库所有者用户ID
database_type: 数据库类型（local或shared）
database_acl: 访问控制信息（内部使用）
database_options: 数据库属性
database_isolation_level: 隔离级别（Snapshot Isolation或Serializable）

`list_schemas`

列出Redshift集群中指定数据库的所有模式，查询SVV_ALL_SCHEMAS系统视图以发现用户有权访问的模式，包括本地模式、外部模式和来自数据共享的共享模式。

使用要求

AWS凭证已正确配置
集群必须可用且可访问
所需IAM权限：redshift-data:ExecuteStatement, redshift-data:DescribeStatement, redshift-data:GetStatementResult
用户必须有权访问数据库以查询系统视图

参数

参数	类型	描述
`cluster_identifier`	`string`	查询模式的集群标识符，必须是`list_clusters`工具返回的有效标识符。
`schema_database_name`	`string`	列出模式的数据库名称（同时用于连接），必须是`list_databases`工具返回的有效名称。

响应结构

返回RedshiftSchema对象列表，包含：

database_name: 模式所在的数据库名称
schema_name: 模式名称
schema_owner: 模式所有者用户ID
schema_type: 模式类型（external、local或shared）
schema_acl: 指定用户或用户组对模式的权限
source_database: 外部模式的源数据库名称
schema_option: 模式选项（外部模式属性）

`list_tables`

列出Redshift数据库中指定模式的所有表，查询SVV_ALL_TABLES系统视图以发现用户有权访问的表，包括基表、视图、外部表和共享表。

使用要求

AWS凭证已正确配置
集群必须可用且可访问
所需IAM权限：redshift-data:ExecuteStatement, redshift-data:DescribeStatement, redshift-data:GetStatementResult
用户必须有权访问数据库以查询系统视图

参数

参数	类型	描述
`cluster_identifier`	`string`	查询表的集群标识符，必须是`list_clusters`工具返回的有效标识符。
`table_database_name`	`string`	列出表的数据库名称，必须是`list_databases`工具返回的有效名称。
`table_schema_name`	`string`	列出表的模式名称（同时用于连接），必须是`list_schemas`工具返回的有效名称。

响应结构

返回RedshiftTable对象列表，包含：

database_name: 表所在的数据库名称
schema_name: 表所在的模式名称
table_name: 表名称
table_acl: 指定用户或用户组对表的权限
table_type: 表类型（views、base tables、external tables、shared tables）
remarks: 表的备注信息

使用场景和适用范围

适用于需要管理和查询Amazon Redshift数据仓库的用户，包括：

数据工程师：用于集群管理和元数据探索
数据分析师：用于查询数据仓库中的数据
开发人员：集成到数据管道或应用程序中执行Redshift操作

使用方法和配置说明

基本使用流程

使用list_clusters获取可用的Redshift集群标识符
使用list_databases获取指定集群中的数据库名称
使用list_schemas获取指定数据库中的模式名称
使用list_tables获取指定模式中的表名称
使用list_columns获取指定表中的列信息
使用execute_query执行SQL查询

Docker部署示例

json
{
  "mcpServers": {
    "awslabs-redshift": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/redshift-mcp-server"
      ]
    }
  }
}