Claude Code で AWS 公式プラグイン「deploy-on-aws」を使ってシンプルなAPIをデプロイしてみた

❯ /plugin marketplace add awslabs/agent-plugins
❯ /plugin install deploy-on-aws@agent-plugins-for-aws

{
  "mcpServers": {
    "awsiac": {
      "args": [
        "awslabs.aws-iac-mcp-server@latest"
      ],
      "command": "uvx"
    },
    "awsknowledge": {
      "type": "http",
      "url": "https://knowledge-mcp.global.api.aws"
    },
    "awspricing": {
      "args": [
        "awslabs.aws-pricing-mcp-server@latest"
      ],
      "command": "uvx",
      "disabled": false,
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "timeout": 120000,
      "type": "stdio"
    }
  }
}

❯ /deploy-on-aws:deploy URL短縮サービスを作りたい

import * as cdk from 'aws-cdk-lib';
import { Construct } from 'constructs';
import * as dynamodb from 'aws-cdk-lib/aws-dynamodb';
import * as lambda from 'aws-cdk-lib/aws-lambda';
import * as apigwv2 from 'aws-cdk-lib/aws-apigatewayv2';
import * as apigwv2Integrations from 'aws-cdk-lib/aws-apigatewayv2-integrations';
import * as path from 'path';

export class UrlShortenerStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    // DynamoDB Table - オンデマンド、暗号化有効
    const table = new dynamodb.Table(this, 'UrlTable', {
      partitionKey: { name: 'shortId', type: dynamodb.AttributeType.STRING },
      billingMode: dynamodb.BillingMode.PAY_PER_REQUEST,
      encryption: dynamodb.TableEncryption.AWS_MANAGED,
      pointInTimeRecovery: true,
      removalPolicy: cdk.RemovalPolicy.DESTROY,
    });

    // Lambda Function
    const fn = new lambda.Function(this, 'UrlShortenerFn', {
      runtime: lambda.Runtime.NODEJS_22_X,
      handler: 'index.handler',
      code: lambda.Code.fromAsset(path.join(__dirname, '..', 'lambda')),
      memorySize: 128,
      timeout: cdk.Duration.seconds(10),
      environment: {
        TABLE_NAME: table.tableName,
      },
      architecture: lambda.Architecture.ARM_64,
    });

    // 最小権限: Lambda → DynamoDB
    table.grantReadWriteData(fn);

    // HTTP API (API Gateway v2)
    const httpApi = new apigwv2.HttpApi(this, 'UrlShortenerApi', {
      apiName: 'url-shortener',
      corsPreflight: {
        allowOrigins: ['*'],
        allowMethods: [apigwv2.CorsHttpMethod.GET, apigwv2.CorsHttpMethod.POST],
      },
    });

    const integration = new apigwv2Integrations.HttpLambdaIntegration(
      'LambdaIntegration',
      fn,
    );

    // POST /shorten - URL短縮
    httpApi.addRoutes({
      path: '/shorten',
      methods: [apigwv2.HttpMethod.POST],
      integration,
    });

    // GET /{shortId} - リダイレクト
    httpApi.addRoutes({
      path: '/{shortId}',
      methods: [apigwv2.HttpMethod.GET],
      integration,
    });

    // Outputs
    new cdk.CfnOutput(this, 'ApiUrl', {
      value: httpApi.apiEndpoint,
      description: 'URL Shortener API endpoint',
    });

    new cdk.CfnOutput(this, 'TableName', {
      value: table.tableName,
      description: 'DynamoDB table name',
    });
  }
}

import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
import { DynamoDBDocumentClient, PutCommand, GetCommand } from '@aws-sdk/lib-dynamodb';
import { randomBytes } from 'crypto';

const client = new DynamoDBClient({});
const docClient = DynamoDBDocumentClient.from(client);
const TABLE_NAME = process.env.TABLE_NAME;

export const handler = async (event) => {
  const { httpMethod, path, body, pathParameters } = parseEvent(event);

  if (httpMethod === 'POST' && path === '/shorten') {
    return await shortenUrl(JSON.parse(body));
  }

  if (httpMethod === 'GET' && pathParameters?.shortId) {
    return await redirectUrl(pathParameters.shortId);
  }

  return { statusCode: 404, body: JSON.stringify({ error: 'Not found' }) };
};

async function shortenUrl({ url }) {
  if (!url) {
    return { statusCode: 400, body: JSON.stringify({ error: 'url is required' }) };
  }

  const shortId = randomBytes(4).toString('hex');

  await docClient.send(new PutCommand({
    TableName: TABLE_NAME,
    Item: { shortId, originalUrl: url, createdAt: new Date().toISOString() },
  }));

  return {
    statusCode: 200,
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ shortId, shortUrl: `/${shortId}` }),
  };
}

async function redirectUrl(shortId) {
  const result = await docClient.send(new GetCommand({
    TableName: TABLE_NAME,
    Key: { shortId },
  }));

  if (!result.Item) {
    return { statusCode: 404, body: JSON.stringify({ error: 'URL not found' }) };
  }

  return {
    statusCode: 301,
    headers: { Location: result.Item.originalUrl },
    body: '',
  };
}

function parseEvent(event) {
  return {
    httpMethod: event.requestContext?.http?.method || event.httpMethod,
    path: event.rawPath || event.path,
    body: event.body,
    pathParameters: event.pathParameters,
  };
}

❯ npm exec cdk deploy --profile test-account --require-approval broadening

 ✅  UrlShortenerStack

✨  Deployment time: 64.19s

Outputs:
UrlShortenerStack.ApiUrl = https://i3mv7mhbyg.execute-api.ap-northeast-1.amazonaws.com
UrlShortenerStack.TableName = UrlShortenerStack-UrlTable6FBD0DEA-1DN2HNO7UG7DC
Stack ARN:
arn:aws:cloudformation:ap-northeast-1:111111111111:stack/UrlShortenerStack/382b8a10-2986-11f1-a894-0e59a1265639

❯ curl -s -X POST https://i3mv7mhbyg.execute-api.ap-northeast-1.amazonaws.com/shorten \
    -H 'Content-Type: application/json' \
    -d '{"url":"https://dev.classmethod.jp"}'

{"shortId":"76dddba5","shortUrl":"/76dddba5"}

❯ curl -s -o /dev/null -w "%{http_code} %{redirect_url}" \
    https://i3mv7mhbyg.execute-api.ap-northeast-1.amazonaws.com/76dddba5

301 https://dev.classmethod.jp/