Redshift MCP Server (typescript) Xqy

🚀 Amazon Redshift MCP サーバー（TypeScript）

このサーバーは、TypeScript で実装された Amazon Redshift 用の Model Context Protocol (MCP) サーバーです。Anthropic の実装パターンに従い、Cursor IDE やその他の MCP 互換クライアントに Redshift データウェアハウスに関する豊富なコンテキスト情報を提供します。このサーバーにより、LLM はデータベーススキーマを調べ、読み取り専用のクエリを実行することができます。

🚀 クイックスタート

MCP クライアントとの統合

プロジェクト固有の設定

プロジェクトディレクトリに .cursor/mcp.json ファイルを作成します。

{
  "mcpServers": {
    "redshift-mcp": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "DATABASE_URL": "redshift://username:password@hostname:port/database?ssl=true"
      }
    }
  }
}

グローバル設定

すべてのプロジェクトで使用するには、ホームディレクトリにある ~/.cursor/mcp.json ファイルを作成し、同じ設定を行います。

クライアント固有の設定

Cursor IDE

1. mcp.json でサーバーを構成すると、自動的に検出されます。
2. ツールは「利用可能なツール」セクションに表示されます。
3. 関連する内容が表示されると、プロキシは自動的にこれらのツールを使用します。

その他の MCP クライアント

stdio トランスポートを使用してサーバーを構成します。

{
  "servers": [
    {
      "name": "redshift-mcp",
      "transport": {
        "kind": "stdio",
        "command": ["node", "path/to/dist/index.js"]
      }
    }
  ]
}

要件

• Node.js 16 以上
• TypeScript
• Amazon Redshift クラスターへのアクセス権
• Redshift と SQL の基礎知識
• Cursor IDE がインストールされていること

📦 インストール

1. このリポジトリをクローンするか、ファイルをローカルシステムにコピーします。
2. 依存関係をインストールします。

npm install

3. TypeScript コードをコンパイルします。

npm run build

💻 使用例

基本的な使用法

サーバーは DATABASE_URL 環境変数を通じて提供する必要があります。

DATABASE_URL=redshift://username:password@hostname:port/database?ssl=true npm start

ここで：

• username: Redshift ユーザー名
• password: Redshift パスワード
• hostname: Redshift サーバーアドレス
• port: ポート（デフォルトは 5432）
• database: 接続するデータベース名

高度な使用法

サーバーを起動します。

DATABASE_URL=redshift://myuser:mypassword@redshift-cluster-1.c1234567890.us-east-1.redshift.amazonaws.com:5432/mydb?ssl=true npm start

その後、http://localhost:4000 で API ドキュメントにアクセスできます。

開発

開発時には、npm run dev コマンドを使用すると、ts-node を使って TypeScript コードを事前にコンパイルすることなく直接実行できます。

📚 ドキュメント

MCP プロトコルの詳細については、MCP Protocol Documentation を参照してください。