MCPに入門してみた

$ node -v
v22.14.0

$ python3 --version
Python 3.12.3

$ uv --version
uv 0.6.16 (d8ad9d3cd 2025-04-22)

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "uvx",
      "args": [
          "--from",
          "awslabs-aws-documentation-mcp-server",
          "awslabs.aws-documentation-mcp-server.exe"
      ],
      "env": {
          "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    },
    "awslabs.cdk-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "awslabs-cdk-mcp-server",
        "awslabs.cdk-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

AWS CDKのベストプラクティスを公式ドキュメントから参照して教えて。

＜中略＞

AWS CDKのベストプラクティス
AWS CDKを効果的に使用するための主要なベストプラクティスは以下のとおりです：
組織的なベストプラクティス
1. 専門家チームの設置: AWS CDKの採用初期段階では、組織内の他のメンバーをトレーニングし指導する専門家チームを設置しましょう。小規模な企業では1〜2人、大企業ではクラウド・センター・オブ・エクセレンス（CCoE）として機能します。
2. ランディングゾーンの作成: AWS内の組織単位を定義する「ランディングゾーン」を作成しましょう。AWS Control Towerを使用して、マルチアカウントシステム全体を単一のインターフェースから構成・管理できます。
3. 開発チームの環境: 開発チームが独自のアカウントを使用してテストし、必要に応じて新しいリソースをデプロイできるようにしましょう。

コーディングのベストプラクティス
1. シンプルに始め、必要に応じて複雑さを追加: 可能な限りシンプルに保ち、要件が複雑な解決策を必要とする場合にのみ複雑さを追加しましょう。
2. AWSウェルアーキテクテッドフレームワークに沿う: CDKアプリケーションはウェルアーキテクテッドフレームワークの「コンポーネント」にマッピングされます。
3. 単一のリポジトリ内の単一パッケージから始める: アプリケーションは1つのリポジトリ内の1つのパッケージから始め、複数のアプリケーションで使用する構成については追加パッケージを使用しましょう。
4. コードのライフサイクルやチームの所有権に基づいてリポジトリに移動: パッケージが複数のアプリケーションで使用されるようになったら、独自のリポジトリに移動させましょう。
5. インフラストラクチャとランタイムコードを同じパッケージに置く: インフラストラクチャとランタイムロジックを実装するコードを単一の自己完結型の構成に組み合わせましょう。

構成（Construct）のベストプラクティス
1. 構成でモデル化し、スタックでデプロイ: 論理的なユニットをStackではなくConstructとして表現し、スタックはデプロイのシナリオに応じて構成を組み合わせ接続するために使用しましょう。
2. 環境変数ではなくプロパティとメソッドで構成: 構成とスタックは環境変数ではなく、プロパティオブジェクトを通じて完全に構成可能にすべきです。
3. インフラストラクチャの単体テスト: 一貫して全ての環境でビルド時に単体テストを実行できるようにしましょう。
4. ステートフルなリソースの論理IDを変更しない: データベースやS3バケットなどのステートフルなリソースの論理IDを変更すると、新しいリソースに置き換えられるため注意が必要です。
5. コンプライアンスには構成だけでは不十分: セキュリティのベストプラクティスを強制するためのL2構成のラッパーを作成するだけでなく、サービスコントロールポリシーやアクセス許可の境界などのAWS機能も使用しましょう。

アプリケーションのベストプラクティス
1. 合成時に決定を下す: デプロイ時ではなく、プログラミング言語の機能を使ってCDKアプリケーション内でリソースの選択などの決定を行いましょう。
2. 生成されたリソース名を使用し、物理名を指定しない: ハードコードされた名前ではなく、CDKが生成するリソース名を使用することで、同じアカウントに同じインフラを複数回デプロイできるようにしましょう。
3. 削除ポリシーとログ保持を定義: プロダクション環境のリソースに対して適切な削除ポリシーとログ保持期間を設定しましょう。
4. デプロイ要件に応じてアプリケーションを複数のスタックに分割: できるだけ多くのリソースを同じスタックに保持しつつ、以下のガイドラインを考慮しましょう：
　・ステートフルなリソース（データベースなど）をステートレスなリソースから分離する
　・名前変更に敏感なステートフルなリソースは、移動や名前変更される可能性の高い構成の中にネストしない
5. 非決定的な動作を避けるためにcdk.context.jsonをコミットする: AWS CDKアプリのコンテキストプロバイダーによって記録された非決定的な値のスナップショットを使用し、それをバージョン管理にコミットしましょう。
6. AWS CDKにロールとセキュリティグループを管理させる: grant()メソッドを使用して、最小限のスコープのアクセス許可でリソース間のアクセスを可能にしましょう。
7. すべての本番ステージをコードでモデル化: 本番環境用のスタックと各ステージ用の個別のスタックを作成し、構成値をコードに組み込みましょう。
8. すべてを測定する: リソースのすべての側面を測定するために、メトリクス、アラーム、ダッシュボードを作成しましょう。

セキュリティのベストプラクティス
1. IAMセキュリティのベストプラクティスに従う: IAMを使用してAWSリソースへのアクセスを安全に制御する際は、IAMのセキュリティベストプラクティスに従いましょう。
2. AWS CDKデプロイメントのアクセス許可を管理する:
　・デプロイ中に使用されるIAMロールを誰が引き受けられるかを制限する
　・デプロイ中に実行できるアクションを制限するためにIAMロールのアクセス許可を変更する
3. 最小権限アクセスの付与:
　・ガードレールを実装し、バイパスを防止する
　・AWS Control Tower、AWS Config、AWS CloudTrail、AWS Security Hubなどのサービスを使用する
　・アクセス許可の境界やサービスコントロールポリシー（SCP）を活用する
4. AWS CDKによってプロビジョニングされたリソース間の権限を管理する:
　・AWS Construct LibraryのL2構成のgrantメソッドを使用して、リソース間のアクセス許可をプロビジョニングする
　・アクセス許可の境界やサービスコントロールポリシー（SCP）を使用して、開発者が独自の権限を昇格させることを防止する

以上が、AWS公式ドキュメントから抽出したAWS CDKのベストプラクティスの主要なポイントです。これらの原則に従うことで、より安全で効率的なインフラストラクチャ管理が可能になります。

リクエスト
{
  `limit`: 5,
  `search_phrase`: `AWS CDK best practices`
}

レスポンス
{"rank_order": 1, "url": "https://docs.aws.amazon.com/cdk/v2/guide/best-practices-security.html", "title": "AWS CDK security best practices - AWS Cloud Development Kit (AWS CDK) v2", "context": "The AWS Cloud Development Kit (AWS CDK) is a powerful tool that developers can use to configure AWS services and provision infrastructure on AWS. With any tool that provides such control and capabilities, organizations will need to establish policies and practices to ensure that the tool is being used in safe and secure ways. For example, organizations may want to restrict developer access to specific services to ensure that they can\u2019t tamper with compliance or cost control measures that are configured in the account."}

レスポンス
{"rank_order": 2, "url": "https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/best-practices.html", "title": "AWS CloudFormation best practices - AWS CloudFormation", "context": "Guidelines and recommendations on how to use CloudFormation more effectively and securely."}

レスポンス
{"rank_order": 3, "url": "https://docs.aws.amazon.com/cdk/v2/guide/best-practices.html", "title": "Best practices for developing and deploying cloud infrastructure with the AWS CDK - AWS Cloud Development Kit (AWS CDK) v2", "context": "With the AWS CDK, developers or administrators can define their cloud infrastructure by using a supported programming language. CDK applications should be organized into logical units, such as API, database, and monitoring resources, and optionally have a pipeline for automated deployments. The logical units should be implemented as constructs including the following:"}

レスポンス
{"rank_order": 4, "url": "https://docs.aws.amazon.com/cdk/v2/guide/home.html", "title": "What is the AWS CDK? - AWS Cloud Development Kit (AWS CDK) v2", "context": "The AWS Cloud Development Kit (AWS CDK) is an open-source software development framework for defining cloud infrastructure in code and provisioning it through AWS CloudFormation."}

レスポンス
{"rank_order": 5, "url": "https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/security-best-practices.html", "title": "Security best practices for CloudFormation - AWS CloudFormation", "context": "Describes guidelines and best practices for addressing security issues in CloudFormation."}