Aurora DSQL MCP スキルがリリース。AI エージェントの DSQL 対応力の向上を確かめてみた

# Node.js がある場合
cd /path/to/your/project
npx skills add https://github.com/awslabs/mcp --skill dsql --yes

# Node.js がない場合（Docker で代替）
cd /path/to/your/project
docker run --rm -v $(pwd):/work -w /work node:22 \
  npx -y skills add https://github.com/awslabs/mcp --skill dsql --yes

# インストール確認
ls .agents/skills/dsql/SKILL.md          # スキル本体
ls .agents/skills/dsql/references/       # development-guide.md, ddl-migrations.md 等
ls .agents/skills/dsql/mcp/              # MCP サーバー設定サンプル、ツール仕様
ls .kiro/skills/dsql                     # Kiro CLI 用シンボリックリンク

# docker/Dockerfile
FROM python:3.12-slim
RUN pip install uv && uvx awslabs.aurora-dsql-mcp-server@latest --help > /dev/null 2>&1
ENTRYPOINT ["uvx", "awslabs.aurora-dsql-mcp-server@latest"]

cd docker/
docker build -t dsql-mcp .

# 起動確認（キャッシュ済みなので約1.8秒）
time docker run --rm dsql-mcp --help

{
  "mcpServers": {
    "aurora-dsql": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "${HOME}/.aws:/root/.aws",
        "-e", "AWS_PROFILE=default",
        "-e", "AWS_REGION=us-west-2",
        "-e", "FASTMCP_LOG_LEVEL=ERROR",
        "dsql-mcp",
        "--cluster_endpoint", "<your-cluster>.dsql.<region>.on.aws",
        "--region", "<region>",
        "--database_user", "admin",
        "--allow-writes"
      ]
    }
  }
}

{
  "mcpServers": {
    "aurora-dsql": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "AWS_ACCESS_KEY_ID",
        "-e", "AWS_SECRET_ACCESS_KEY",
        "-e", "AWS_SESSION_TOKEN",
        "-e", "AWS_DEFAULT_REGION=us-west-2",
        "-e", "FASTMCP_LOG_LEVEL=ERROR",
        "dsql-mcp",
        "--cluster_endpoint", "<your-cluster>.dsql.<region>.on.aws",
        "--region", "<region>",
        "--database_user", "admin",
        "--allow-writes"
      ]
    }
  }
}

{
  "mcpServers": {
    "aurora-dsql-docs-only": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "FASTMCP_LOG_LEVEL=ERROR", "dsql-mcp"]
    }
  }
}

<!-- .kiro/steering/dsql-rules.md -->
## Aurora DSQL 接続情報
- クラスタエンドポイント: <your-cluster>.dsql.<region>.on.aws
- リージョン: us-west-2
- 認証: IAM（dsql:DbConnectAdmin）
- DB名: postgres（DSQL固定）
- ユーザー: admin

## ⚠️ DSQL 作業時の必須手順
DSQL 関連のコード変更・スキーマ変更を行う際は、必ず以下の手順を守ること。

1. まず `.agents/skills/dsql/SKILL.md` を読み込む
2. その中の指示に従い、必要なリファレンス（DDLルール等）を確認する
3. 決して PostgreSQL の一般知識だけで推測で操作しないこと

aws dsql create-cluster --deletion-protection-enabled --region us-west-2
# → クラスタ識別子とエンドポイントが返る（即座に ACTIVE）

# EC2 インスタンスプロファイル（IAM ロール）の場合
TOKEN=$(curl -s -X PUT "http://169.254.169.254/latest/api/token" \
  -H "X-aws-ec2-metadata-token-ttl-seconds: 21600")
CREDS=$(curl -s -H "X-aws-ec2-metadata-token: $TOKEN" \
  http://169.254.169.254/latest/meta-data/iam/security-credentials/$(
    curl -s -H "X-aws-ec2-metadata-token: $TOKEN" \
    http://169.254.169.254/latest/meta-data/iam/security-credentials/))
export AWS_ACCESS_KEY_ID=$(echo $CREDS | python3 -c "import sys,json; print(json.load(sys.stdin)['AccessKeyId'])")
export AWS_SECRET_ACCESS_KEY=$(echo $CREDS | python3 -c "import sys,json; print(json.load(sys.stdin)['SecretAccessKey'])")
export AWS_SESSION_TOKEN=$(echo $CREDS | python3 -c "import sys,json; print(json.load(sys.stdin)['Token'])")

# ローカル環境（~/.aws/credentials や aws sso）の場合
eval $(aws sts assume-role \
  --role-arn arn:aws:iam::<account-id>:role/<role-name> \
  --role-session-name dsql-mcp \
  --query 'Credentials.[AccessKeyId,SecretAccessKey,SessionToken]' \
  --output text | awk '{printf "export AWS_ACCESS_KEY_ID=%s\nexport AWS_SECRET_ACCESS_KEY=%s\nexport AWS_SESSION_TOKEN=%s\n",$1,$2,$3}')

# または、ホストの認証情報をそのままマウントする方法
# docker run --rm -i -v ~/.aws:/root/.aws -e AWS_PROFILE=default ...

(
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
sleep 2
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"transact","arguments":{"sql_list":["CREATE TABLE example (id VARCHAR(255) PRIMARY KEY, name TEXT)"]}}}'
sleep 3
) | timeout 30 docker run --rm -i \
  -e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
  -e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
  -e AWS_SESSION_TOKEN=$AWS_SESSION_TOKEN \
  -e AWS_DEFAULT_REGION=us-west-2 \
  -e FASTMCP_LOG_LEVEL=ERROR \
  dsql-mcp \
  --cluster_endpoint <your-cluster>.dsql.us-west-2.on.aws \
  --region us-west-2 \
  --database_user admin \
  --allow-writes

.agents/skills/dsql/SKILL.md を読んで、必要な参照ドキュメントをロードしてから作業して