Redshift MCP Server

Redshift MCP 服务

用于与 Amazon Redshift 数据库交互的模型上下文协议（MCP）服务。

功能

• 在 Redshift 上运行 SQL 查询
• 说明 SQL 查询的执行计划
• 列出架构中的表和视图
• 列出数据库中的所有架构
• 测试与 Redshift 的连接

前提条件

• Python 3.10+
• Amazon Redshift 数据库凭据

安装

安装要求

1. 从 Astral 或 GitHub README 安装 uv
2. 使用 uv python install 3.10 安装 Python 3.10 或更新版本（也可以安装更新版本）

为 Amazon Q 或 Claude 配置

要将此 MCP 服务添加到 Amazon Q 或 Claude，请将以下内容添加到 MCP 配置文件中。对于 Amazon Q，在运行 q chat 的同一目录下创建名为 .amazonq/mcp.json 的文件（如果该文件尚不存在）。然后添加以下配置：

{
  "mcpServers": {
    "redshift": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--with", "<path-to-redshift-mcp-server>", "redshift-mcp-server"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

设置凭据

⚠️ 安全警告 ⚠️

切勿将凭据文件提交到版本控制系统，或将其包含在 Docker 镜像中！

使用环境变量设置 Redshift 凭据：

# Linux/macOS
export REDSHIFT_HOST=<your-redshift-host>
export REDSHIFT_PORT=5439  # Default Redshift port
export REDSHIFT_DATABASE=<your-database-name>
export REDSHIFT_USER=<your-username>
export REDSHIFT_PASSWORD=<your-password>

# Windows (Command Prompt)
set REDSHIFT_HOST=<your-redshift-host>
set REDSHIFT_PORT=5439
set REDSHIFT_DATABASE=<your-database-name>
set REDSHIFT_USER=<your-username>
set REDSHIFT_PASSWORD=<your-password>

# Windows (PowerShell)
$env:REDSHIFT_HOST = "<your-redshift-host>"
$env:REDSHIFT_PORT = "5439"
$env:REDSHIFT_DATABASE = "<your-database-name>"
$env:REDSHIFT_USER = "<your-username>"
$env:REDSHIFT_PASSWORD = "<your-password>"

开发

1. 克隆此代码库：

   git clone https://github.com/tuanknguyen/redshift-mcp-server.git
   cd redshift-mcp-server
   

2. 创建并激活虚拟环境：

   # Create the venv
   uv venv
   
   # Activate it
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 安装项目：

   # Install the project and its dependencies
   uv pip install -e .
   
   # Or for development
   uv pip install -e ".[dev]"
   

配置

设置以下环境变量，填入 Redshift 连接详情：

export REDSHIFT_HOST=<your-redshift-host>
export REDSHIFT_PORT=5439  # Default Redshift port
export REDSHIFT_DATABASE=<your-database-name>
export REDSHIFT_USER=<your-username>
export REDSHIFT_PASSWORD=<your-password>

可选环境变量：

export FASTMCP_LOG_LEVEL=INFO  # Set log level (DEBUG, INFO, WARNING, ERROR)

开发模式

使用 MCP Inspector 进行开发和测试：

mcp dev redshift-mcp-server

可用工具

• run_query(query: str) - 在 Redshift 上执行 SQL 查询
• explain_query(query: str) - 获取 SQL 查询的执行计划
• list_tables_in_schema(schema_name: str) - 列出指定架构中的所有表和视图
• list_schemas() - 列出数据库中的所有架构
• test_redshift_connection() - 测试与 Redshift 数据库的连接

连接测试

MCP 服务会在启动时自动测试连接。如果连接测试失败，服务将无法启动并报错。

你也可以使用以下命令单独测试连接：

python test_connection.py

最佳实践

• 使用 list_schemas 和 list_tables_in_schema 探索数据库结构
• 对于大型查询，可先使用 explain_query 了解执行计划
• 始终添加适当的 WHERE 子句以限制结果集
• 显式指定列名，而不是使用 SELECT *，以获得更好的性能
• 考虑添加 LIMIT 子句，避免返回过多行