My Redshift MCP

🚀 Redshift MCP Server

Amazon Redshift用の即座に使えるModel Context Protocol (MCP)サーバーです。LLMやAIエージェント（Claude、ChatGPTなど）を安全かつ簡単にRedshiftのデータに接続できます。

✨ 主な機能

• 本番環境対応：安全で堅牢で、デプロイが簡単です。
• MCP標準対応：RedshiftをLLM/AI向けの標準化されたツールとして公開します。
• 厳格なアクセスモード：readonly、readwrite、admin（環境変数で制御）
• 自動接続：環境変数または.envファイルを使用して、シームレスに起動できます。
• コード変更不要：設定して実行するだけです。
• 拡張性：新しいツールやビジネスロジックを簡単に追加できます。
• Claude Desktop、ChatGPT、およびすべてのMCPクライアントと互換性

🚀 クイックスタート

1. クローンとインストール

   git clone <repo-url>
   cd my-redshift-mcp
   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   

2. 設定（推奨：.envファイルを作成）：

   REDSHIFT_HOST=your-cluster.region.redshift.amazonaws.com
   REDSHIFT_DATABASE=mydb
   REDSHIFT_USER=myuser
   REDSHIFT_PASSWORD=mypassword
   REDSHIFT_PORT=5439
   DB_MCP_MODE=readonly
   

3. サーバーを起動

   ./scripts/run_server.sh
   

4. LLM/MCPクライアントから接続（例：Claude Desktop）

📚 ドキュメント

Redshift MCP Serverとは？

Redshift MCP Serverは、Amazon Redshiftと最新のAIアシスタントの間のオープンソースのブリッジです。LLMがModel Context Protocol (MCP)を使用して、Redshiftのデータを安全にクエリ、探索、（オプションで）変更できるようにします。以下の用途に最適です。

• AIによる分析を可能にするデータチーム
• AIワークフローと自動化の構築
• 本番データへの安全で監査可能なLLMアクセス

このプロジェクトについて

このリポジトリは、FastMCPフレームワークを使用したAmazon Redshift用の最小限で本番環境対応のMCPサーバーを提供します。LLMやAIエージェントが以下の操作を行えるようにします。

• Redshiftデータベースをクエリ（厳格なアクセス制御付き）
• スキーマとテーブルをリストする
• テーブル構造を説明する
• （オプションで）設定されたモードに応じて、データを挿入/更新する

主な機能：

• 3つのアクセスモード：readonly、readwrite、admin（以下を参照）
• 環境変数と.envファイルのサポートによる簡単な設定
• デフォルトで安全：readonlyモードで起動
• Claude Desktop、ChatGPT、およびすべてのMCPクライアントと互換性
• 新しいツールやビジネスロジックを簡単に拡張できる

機能

このMCPサーバーは、Redshiftデータベース操作のための以下のツールを提供します。

• connect_db：Redshiftクラスターに接続する（環境変数をサポート）
• query：オプションのパラメーターバインディングでSELECTクエリを実行する
• execute：INSERT、UPDATE、DELETE、またはDDLステートメントを実行する
• list_schemas：データベース内のすべてのスキーマをリストする
• list_tables：特定のスキーマ内のテーブルをリストする
• describe_table：テーブルの詳細な構造を取得する
• disconnect：データベース接続を閉じる

自動接続サポート

サーバーは、環境変数を使用して起動時に自動接続をサポートしています。すべての必要な環境変数が設定されている場合、サーバーは起動時に自動的に接続します。

アクセスモードとクエリの安全性

サーバーは、DB_MCP_MODE環境変数で制御される3つのアクセスモードをサポートしています。

1. readonly（デフォルト）

• 許可：SELECT、SHOW、DESCRIBEなど
• ブロック：INSERT、UPDATE、DELETE、DROP、TRUNCATE、ALTER、CREATE、GRANT、REVOKE、COMMENT、SET、COPY、UNLOAD、VACUUM、ANALYZE、MERGE

2. readwrite

• 許可：SELECT、INSERT、UPDATE、CREATEなど
• ブロック：DELETE、DROP、TRUNCATE、ALTER、GRANT、REVOKE、COMMENT、SET、COPY、UNLOAD、VACUUM、ANALYZE、MERGE

3. admin

• すべて許可（制限なし）

禁止されたステートメントが検出された場合、サーバーは明確なエラーメッセージを返します。

モードの設定方法

• 環境変数：DB_MCP_MODE=readonly（またはreadwrite、admin）
• Claude Desktopの設定：

  "env": {
    "DB_MCP_MODE": "readwrite",
    ...
  }
  

• シェル/ローカル：

  export DB_MCP_MODE=readonly
  ./run_server.sh
  

インストール

1. このリポジトリをクローンまたはダウンロードします。
2. 依存関係をインストールします。

pip install -r requirements.txt

使用方法

サーバーの実行

サーバーを直接実行します。

python src/redshift_mcp_server.py

または、提供されているスクリプトを使用します。

./scripts/run_server.sh
# またはWindowsの場合:
scripts\run_server.bat

デフォルトでは、サーバーはSTDIOトランスポートを使用して実行され、Claude DesktopなどのMCPクライアントとの統合に適しています。

Claude Desktopの設定

このサーバーをClaude Desktopと一緒に使用するには、Claude Desktopの設定ファイルに以下の設定を追加します。 macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

オプション1：環境変数を使用する（推奨）

{
  "mcpServers": {
    "redshift": {
      "command": "/Users/anshulpatre/Desktop/DB-mcp/my-redshift-mcp/venv/bin/python",
      "args": ["/Users/anshulpatre/Desktop/DB-mcp/my-redshift-mcp/src/redshift_mcp_server.py"],
      "env": {
        "REDSHIFT_HOST": "your-cluster.region.redshift.amazonaws.com",
        "REDSHIFT_DATABASE": "mydb",
        "REDSHIFT_USER": "myuser",
        "REDSHIFT_PASSWORD": "mypassword",
        "REDSHIFT_PORT": "5439",
        "DB_MCP_MODE": "readonly"
      }
    }
  }
}

この設定では、サーバーは起動時に自動的にRedshiftデータベースに接続します。connect_dbツールを手動で使用する必要はありません。

オプション2：環境変数を使用しない

{
  "mcpServers": {
    "redshift": {
      "command": "/Users/anshulpatre/Desktop/DB-mcp/my-redshift-mcp/venv/bin/python",
      "args": ["/Users/anshulpatre/Desktop/DB-mcp/my-redshift-mcp/src/redshift_mcp_server.py"]
    }
  }
}

この設定では、connect_dbツールを使用して接続を確立する必要があります。

環境変数

サーバーは以下の環境変数をサポートしています。

• REDSHIFT_HOST：Redshiftクラスターのエンドポイント
• REDSHIFT_DATABASE：データベース名
• REDSHIFT_USER：ユーザー名
• REDSHIFT_PASSWORD：パスワード
• REDSHIFT_PORT：ポート番号（デフォルト：5439）
• DB_MCP_MODE：アクセスモード（readonly、readwrite、admin）

これらの環境変数が設定されている場合、サーバーは以下のように動作します。

1. 起動時に自動的に接続する
2. パラメーターが指定されていない場合、connect_dbツールのデフォルト値として使用する
3. 選択されたモードに基づいて、クエリ/ステートメントの制限を適用する

利用可能なツール

1. connect_db

Redshiftデータベースクラスターに接続します。環境変数が設定されている場合、パラメーターはオプションです。

# 明示的なパラメーターを使用する場合
{
  "tool": "connect_db",
  "arguments": {
    "host": "your-cluster.region.redshift.amazonaws.com",
    "database": "mydb",
    "user": "myuser",
    "password": "mypassword",
    "port": 5439
  }
}

# 環境変数が設定されている場合
{
  "tool": "connect_db",
  "arguments": {}
}

2. query

SELECTクエリを実行してデータを取得します。

{
  "tool": "query",
  "arguments": {
    "sql": "SELECT * FROM users WHERE created_at > %s",
    "params": ["2024-01-01"]
  }
}

3. execute

データ変更またはDDLステートメントを実行します。

{
  "tool": "execute",
  "arguments": {
    "sql": "INSERT INTO users (name, email) VALUES (%s, %s)",
    "params": ["John Doe", "john@example.com"]
  }
}

4. list_schemas

ユーザーが作成したすべてのスキーマをリストします。

{
  "tool": "list_schemas",
  "arguments": {}
}

5. list_tables

特定のスキーマ内のテーブルをリストします。

{
  "tool": "list_tables",
  "arguments": {
    "schema": "public"
  }
}

6. describe_table

テーブルの構造に関する詳細情報を取得します。

{
  "tool": "describe_table",
  "arguments": {
    "table": "users",
    "schema": "public"
  }
}

7. disconnect

データベース接続を閉じます。

{
  "tool": "disconnect",
  "arguments": {}
}

セキュリティに関する考慮事項

• 資格情報：MCP設定ファイルで環境変数を使用することを推奨します。これにより、資格情報がコードやツール呼び出しから除外されます。
• パーミッション：必要最小限のパーミッションを持つデータベースユーザーを使用します。
• クエリの安全性：サーバーはパラメータ化されたクエリを使用してSQLインジェクションを防止します。クエリ/ステートメントの種類は、選択されたモードに従ってチェックされ、ブロックされます。
• ネットワークセキュリティ：RedshiftクラスターがVPCとセキュリティグループで適切に保護されていることを確認します。

開発

このサーバーを拡張するには：

1. @mcp.tool()デコレーターを使用して新しいツールを追加します。
2. 高度な機能についてはFastMCPのドキュメントを参照します。
3. あなたのRedshiftクラスターで十分にテストします。

トラブルシューティング

接続問題

• Redshiftクラスターのエンドポイントと資格情報を確認します。
• ネットワーク接続とセキュリティグループの設定を確認します。
• クラスターがアクティブで接続を受け付けていることを確認します。

インポートエラー

• redshift-connectorが利用できない場合、サーバーはpsycopg2にフォールバックします。
• あなたのニーズに合わせて適切なコネクタをインストールします。

ライセンス

MIT

貢献

このMCPサーバーを改善するために、問題やプルリクエストを送信してください。

👤 メンテナ

このRedshift MCP Serverは、Anshulによってメンテナンスされ、デプロイされています。