Redshift MCP Server

🚀 Amazon Redshift MCP 服務器

一個基於 Amazon Redshift 的模型上下文協議 (MCP) 服務器，使 AI 助手能夠與 Redshift 數據庫交互。藉助該服務器，AI 助手可方便地對數據庫進行操作，提升數據處理效率。

🚀 快速開始

Redshift MCP 服務器是 Model Context Protocol 的 Python 實現，提供工具和資源用於與 Amazon Redshift 數據庫交互。它允許 AI 助手執行以下操作：

• 列出數據庫中的架構和表
• 獲取表的 DDL（數據定義語言）腳本
• 獲取表統計信息
• 執行 SQL 查詢
• 分析表以收集統計信息
• 獲取 SQL 查詢的執行計劃

📦 安裝指南

先決條件

• Python 3.13 或更高版本
• Amazon Redshift 集群
• Redshift 憑據（主機、端口、用戶名、密碼、數據庫）

從源代碼安裝

# 克隆倉庫
git clone https://github.com/Moonlight-CL/redshift-mcp-server.git
cd redshift-mcp-server

# 安裝依賴項
uv sync

🔧 配置

服務器需要以下環境變量來連接到您的 Redshift 集群：

RS_HOST=your-redshift-cluster.region.redshift.amazonaws.com
RS_PORT=5439
RS_USER=your_username
RS_PASSWORD=your_password
RS_DATABASE=your_database
RS_SCHEMA=your_schema  # 可選，默認為 "public"

您可以直接設置這些環境變量，或使用 .env 文件。

💻 使用示例

啟動服務器

# 啟動服務器
uv run --with mcp python-dotenv redshift-connector mcp
mcp run src/redshift_mcp_server/server.py

與 AI 助手集成

要將此服務器與支持 MCP 的 AI 助手一起使用，請在您的 MCP 設置中添加以下配置：

{
  "mcpServers": {
    "redshift": {
      "command": "uv",
      "args": ["--directory", "src/redshift_mcp_server", "run", "server.py"],
      "env": {
        "RS_HOST": "your-redshift-cluster.region.redshift.amazonaws.com",
        "RS_PORT": "5439",
        "RS_USER": "your_username",
        "RS_PASSWORD": "your_password",
        "RS_DATABASE": "your_database",
        "RS_SCHEMA": "your_schema"
      }
    }
  }
}

基礎用法

列出架構

access_mcp_resource("redshift-mcp-server", "rs:///schemas")

列出架構中的表

access_mcp_resource("redshift-mcp-server", "rs:///public/tables")

獲取表 DDL

access_mcp_resource("redshift-mcp-server", "rs:///public/users/ddl")

執行 SQL

use_mcp_tool("redshift-mcp-server", "execute_sql", {"sql": "SELECT * FROM public.users LIMIT 10"})

分析表

use_mcp_tool("redshift-mcp-server", "analyze_table", {"schema": "public", "table": "users"})

獲取執行計劃

use_mcp_tool("redshift-mcp-server", "get_execution_plan", {"sql": "SELECT * FROM public.users LIMIT 10"})

✨ 主要特性

資源

服務器提供以下資源：

• rs:///schemas - 列出數據庫中的所有架構
• rs:///{schema}/tables - 列出特定架構中的所有表
• rs:///{schema}/{table}/ddl - 獲取特定表的 DDL 腳本
• rs:///{schema}/{table}/statistic - 獲取特定表的統計信息

工具

服務器提供以下工具：

• execute_sql - 在 Redshift 集群上執行 SQL 查詢
• analyze_table - 分析表以收集統計信息
• get_execution_plan - 獲取 SQL 查詢的執行計劃及其運行時統計信息

📚 詳細文檔

開發

項目結構

.
├── src/
│   └── redshift_mcp_server/
│       ├── server.py
│       └── [其他模塊]
└── [其他文件]

依賴項

• uv - MCP 協議的實現
• python-dotenv - 加載環境變量
• redshift-connector - Redshift 連接器