AWS ラボ Aurora DSQL MCP サーバー

Aurora DSQL 用の AWS ラボモデルコンテキストプロトコル (MCP) サーバー

機能

使用可能なツール

データベースのオペレーション

ドキュメントと推奨事項

前提条件

インストール

の使用uv

MCP クライアント設定で MCP サーバーを設定します (Amazon Q Developer CLI の場合は、~/.aws/amazonq/mcp.json を編集します)。

{
  "mcpServers": {
    "awslabs.aurora-dsql-mcp-server": {
      "command": "uvx",
      "args": [
        "awslabs.aurora-dsql-mcp-server@latest",
        "--cluster_endpoint",
        "[your dsql cluster endpoint, e.g. abcdefghijklmnopqrst234567.dsql.us-east-1.on.aws]",
        "--region",
        "[your dsql cluster region, e.g. us-east-1]",
        "--database_user",
        "[your dsql username, e.g. admin]",
        "--profile",
        "default"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Windows のインストール

Windows ユーザーの場合、MCP サーバー設定形式は若干異なります。

{
  "mcpServers": {
    "awslabs.aurora-dsql-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.aurora-dsql-mcp-server@latest",
        "awslabs.aurora-dsql-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

インストールの検証

Amazon Q Developer CLI の場合は、/mcp を実行して MCP サーバーのステータスを確認します。

サーバー設定オプション

--allow-writes

デフォルトでは、dsql MCP サーバーは書き込みオペレーション (「読み取り専用モード」) を許可しません。トランザクションツールの呼び出しは、このモードでは失敗します。トランザクションツールを使用するには、--allow-writes パラメータを渡して書き込みを許可します。

DSQL に接続するときは、最小特権アクセスを使用することをお勧めします。例えば、ユーザーは可能な限り読み取り専用のロールを使用する必要があります。読み取り専用モードには、ミューテーションを拒否するためのベストエフォートなクライアント側の強制があります。

--cluster_endpoint

これは、接続するクラスターを指定するための必須パラメータです。これはクラスターの完全なエンドポイントである必要があります。例: 01abc2ldefg3hijklmnopqurstu.dsql.us-east-1.on.aws

--database_user

これは、接続するユーザーを指定するための必須パラメータです。例えば、admin または my_user など。使用している AWS 認証情報には、そのユーザーとしてログインするためのアクセス許可が必要です。DSQL でのデータベースロールの設定と使用の詳細については、「IAM ロールでのデータベースロールの使用」を参照してください。

--profile

認証情報に使用する aws プロファイルを指定できます。これは docker のインストールではサポートされていないことに注意してください。

MCP 設定での AWS_PROFILE 環境変数の使用もサポートされています。

"env": {
  "AWS_PROFILE": "your-aws-profile"
}

どちらも指定されていない場合、MCP サーバーはデフォルトで AWS 設定ファイルの「デフォルト」プロファイルを使用します。

--region

これは、DSQL データベースのリージョンを指定するための必須パラメータです。

--knowledge-server

DSQL ナレッジツール (ドキュメント検索、読み取り、レコメンデーション) のリモート MCP サーバーエンドポイントを指定するオプションのパラメータ。デフォルトでは、事前設定されています。

例:

--knowledge-server https://custom-knowledge-server.example.com

注: セキュリティのため、信頼できるナレッジサーバーエンドポイントのみを使用してください。サーバーは HTTPS エンドポイントである必要があります。

--knowledge-timeout

ナレッジサーバーへのリクエストのタイムアウトを秒単位で指定するオプションのパラメータ。

デフォルト: 30.0

例:

--knowledge-timeout 60.0

低速ネットワークでドキュメントにアクセスするときにタイムアウトが発生した場合は、この値を増やします。