Redshift MCP Server

🚀 Amazon Redshift MCP サーバー

Amazon Redshift ベースのモデルコンテキストプロトコル (MCP) サーバーで、AI アシスタントが Redshift データベースとやり取りできるようにします。

🚀 クイックスタート

Redshift MCP サーバーは Model Context Protocol の Python 実装で、Amazon Redshift データベースとのやり取りに必要なツールとリソースを提供します。これにより、AI アシスタントは以下の操作を実行できます。

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

✨ 主な機能

リソース

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

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

ツール

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

• execute_sql - Redshift クラスター上で SQL クエリを実行
• analyze_table - テーブルを分析して統計情報を収集
• get_execution_plan - 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"})

🔧 技術詳細

プロジェクト構造

.
├── src/
│   └── redshift_mcp_server/
│       ├── server.py
│       └── [その他のモジュール]
└── [その他のファイル]

依存関係

• uv - MCP プロトコルの実装
• python-dotenv - 環境変数の読み込み
• redshift-connector - Redshift コネクタ