Redshift MCP Server

Redshift MCP Server

Amazon Redshift 用の Model Context Protocol（MCP）サーバーです。AI アシスタントが Redshift データベースとやり取りできるようにします。

はじめに

Redshift MCP Server は、Amazon Redshift データベースとやり取りするためのツールとリソースを提供する、Model Context Protocol の Python ベースの実装です。AI アシスタントは次の操作を実行できます。

• Redshift データベース内のスキーマとテーブルを一覧表示する
• テーブルの DDL（データ定義言語）スクリプトを取得する
• テーブルの統計情報を取得する
• SQL クエリを実行する
• テーブルを分析して統計情報を収集する
• SQL クエリの実行計画を取得する

インストール

前提条件

• Python 3.13 以降
• Amazon Redshift クラスター
• Redshift の認証情報（ホスト、ポート、ユーザー名、パスワード、データベース）

ソースからインストール

# Clone the repository
git clone https://github.com/Moonlight-CL/redshift-mcp-server.git
cd redshift-mcp-server

# Install dependencies
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  # Optional, defaults to "public"

これらの環境変数は直接設定するか、.env ファイルを使用できます。

使用方法

サーバーの起動

# Start the server
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"
      }
    }
  }
}

機能

リソース

サーバーは次のリソースを提供します。

• rs:///schemas - データベース内のすべてのスキーマを一覧表示します
• rs:///{schema}/tables - 指定したスキーマ内のすべてのテーブルを一覧表示します
• rs:///{schema}/{table}/ddl - 指定したテーブルの DDL スクリプトを取得します
• rs:///{schema}/{table}/statistic - 指定したテーブルの統計情報を取得します

ツール

サーバーは次のツールを提供します。

• execute_sql - Redshift クラスターで SQL クエリを実行します
• analyze_table - テーブルを分析して統計情報を収集します
• get_execution_plan - SQL クエリの実行時統計情報を含む実行計画を取得します

例

スキーマの一覧表示

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 WHERE user_id = 123"})

開発

プロジェクト構成

redshift-mcp-server/
├── src/
│   └── redshift_mcp_server/
│       ├── __init__.py
│       └── server.py
├── pyproject.toml
└── README.md

依存関係

• mcp[cli]>=1.5.0 - Model Context Protocol SDK
• python-dotenv>=1.1.0 - .env ファイルから環境変数を読み込むためのライブラリ
• redshift-connector>=2.1.5 - Amazon Redshift 用の Python コネクター