mcpserver.so LogoMCPFly
Submit
AWS Trusted Advisor MCP Server logo

AWS Trusted Advisor MCP Server

by enomoto11

Cloud/AutomationAWSTrusted AdvisorAutomationEC2EBSIAMS3IaC

This project provides an MCP (Multimodal Conversational Processing) server that leverages AWS Trusted Advisor. It suggests recommended changes based on AWS Trusted Advisor check results, such as stopping EC2 instances or creating EBS snapshots.

View on GitHub

Last updated: N/A

AWS Trusted Advisor MCP サーバー

このプロジェクトは、AWS Trusted Advisorの機能を活用するMCP (Multimodal Conversational Processing) サーバーを提供します。AWS Trusted Advisorのチェック結果に基づいて、EC2インスタンスの停止、EBSスナップショットの作成など、推奨される変更を提案します。重要: このツールは実際に変更を行わず、IaCで管理された環境でも安全に使用できます。

リポジトリURL: https://github.com/enomoto11/aws-trusted-advisor-mcp-server

機能

  • 低利用率EC2インスタンスの停止提案: Trusted Advisorによって検出された低利用率のEC2インスタンスを特定し、タグに基づいて停止の提案をします
  • EBSスナップショットの作成提案: バックアップが不足しているEBSボリュームのスナップショット作成を提案します
  • 公開されたアクセスキーの無効化提案: 公開されたIAMアクセスキーを検出し、無効化の提案をします
  • S3バケットバージョニングの有効化提案: バージョニングが有効になっていないS3バケットを特定し、バージョニング有効化の提案をします

セットアップ

前提条件

  • Node.js 14以上
  • npm または yarn
  • AWS アカウントとIAMユーザー (Trusted Advisor および関連サービスへのアクセス権が必要)
  • または Docker と Docker Compose (コンテナで実行する場合)

インストール

# リポジトリをクローン
git clone https://github.com/enomoto11/aws-trusted-advisor-mcp-server.git
cd aws-trusted-advisor-mcp-server

# 依存関係のインストール
npm install

# 開発モードで実行
npm run dev

Dockerを使用した実行

プロジェクトはDockerコンテナとしても実行できます。

# イメージをビルドして起動
docker-compose up -d

# ログの確認
docker-compose logs -f

# コンテナの停止
docker-compose down

AWS認証情報の設定

このプロジェクトはAWS SDKを使用するため、以下のいずれかの方法でAWS認証情報を設定する必要があります：

1. .env ファイルを使用する方法

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加します：

AWS_ACCESS_KEY_ID=あなたのアクセスキーID
AWS_SECRET_ACCESS_KEY=あなたのシークレットアクセスキー
AWS_SESSION_TOKEN=あなたのセッショントークン（必要な場合）
AWS_REGION=us-east-1
2. AWS設定ファイルを使用する方法

AWS CLIがインストールされている場合は、以下のコマンドで認証情報を設定します：

aws configure
3. 環境変数を使用する方法

シェルで直接環境変数を設定します：

export AWS_ACCESS_KEY_ID=あなたのアクセスキーID
export AWS_SECRET_ACCESS_KEY=あなたのシークレットアクセスキー
export AWS_SESSION_TOKEN=あなたのセッショントークン（必要な場合）
export AWS_REGION=us-east-1

重要: Trusted Advisor APIを使用するには、IAMユーザーに適切な権限が必要です。少なくとも support:DescribeTrustedAdvisorChecks および support:DescribeTrustedAdvisorCheckResult アクセス許可が必要です。

Cursorでの設定と使用方法

Cursorエディタでこのツールを使用するには、以下の手順に従ってください：

1. MCPサーバーの設定

  1. このリポジトリをローカルにクローンします
  2. 依存関係をインストールし、サーバーを起動します 
    npm install
npm run dev
  3. サーバーが http://localhost:3000 で起動していることを確認します

2. Cursor MCPプラグインの設定

  1. Cursorエディタを開きます
  2. 設定画面を開きます（macOSでは Cmd+,、Windowsでは Ctrl+,）
  3. 左側のメニューから「Extensions」または「拡張機能」を選択します
  4. 「MCP」セクションを探して選択します
  5. 「Add MCP」または「MCPを追加」ボタンをクリックします
  6. 以下の情報を入力します：
    • Name: Trusted Advisor
    • URL: http://localhost:3000（直接実行の場合）または http://localhost:3001（Dockerコンテナ実行の場合）
  7. 「Add」または「追加」ボタンをクリックして保存します

3. Cursor内での使用方法

  1. コマンドパレットを開きます（macOSでは Cmd+Shift+P、Windowsでは Ctrl+Shift+P）
  2. MCP: Switch MCP Server と入力します
  3. リストから「Trusted Advisor」を選択します
  4. これで、AIアシスタントとのチャットでTrusted Advisorのツールが使用できるようになります
  5. チャットで「低利用率EC2インスタンスをチェックしてください」などと指示すると、MCPサーバーを通じてAWS環境の分析結果が表示されます

4. チャットプロンプトの例

  • 「低利用率のEC2インスタンスをチェックして、停止すべきインスタンスを提案してください」
  • 「バックアップが必要なEBSボリュームをスキャンして、スナップショット作成が必要なものを教えてください」
  • 「公開されているIAMアクセスキーがないか確認してください」
  • 「バージョニングが有効になっていないS3バケットをチェックしてください」

使用方法

サーバーが起動すると、以下のエンドポイントが利用可能になります：

  • GET /: サーバーステータスの確認
  • GET /tools: 利用可能なツールの一覧を取得
  • POST /execute: ツールを実行

ツールの実行例

以下の例では、ローカル実行時のポート3000を使用しています。Dockerコンテナ実行時はポート3001に置き換えてください。

低利用率EC2インスタンスの停止提案
curl -X POST http://localhost:3000/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "low_utilization_ec2_instances",
    "parameters": {
      "region": "us-east-1",
      "tagKey": "environment",
      "tagValue": "dev"
    }
  }'
EBSスナップショットの作成提案
curl -X POST http://localhost:3000/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "ebs_snapshots",
    "parameters": {
      "region": "all"
    }
  }'
公開されたアクセスキーの無効化提案
curl -X POST http://localhost:3000/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "exposed_access_keys",
    "parameters": {}
  }'
S3バケットバージョニングの有効化提案
curl -X POST http://localhost:3000/execute \
  -H "Content-Type: application/json" \
  -d '{
    "toolName": "s3_bucket_versioning",
    "parameters": {}
  }'

推奨事項のフォーマット

このツールは各リソースに対して以下の情報を含む推奨事項を提供します：

  • recommendedAction: 実行すべきAWS CLIコマンド
  • terraformExample: IaCで管理されているリソース向けのTerraformコード例
  • managedWarning: リソースがIaCで管理されている場合の警告メッセージ

例：

{
  "recommendations": [
    {
      "instanceId": "i-0123456789abcdef0",
      "region": "us-east-1",
      "recommendedAction": "aws ec2 stop-instances --instance-ids i-0123456789abcdef0 --region us-east-1",
      "terraformExample": "# Terraformの例:\nresource \"aws_instance\" \"0123456789abcdef0\" {\n  # 他の設定はそのままに\n  instance_id = \"i-0123456789abcdef0\"\n  # インスタンスを停止状態に設定\n  instance_initiated_shutdown_behavior = \"stop\"\n}",
      "managedWarning": "※注意: このインスタンスは terraform:managed=true で管理されています。変更はIaCツールを通じて行ってください。"
    }
  ]
}

カスタムツールの追加

新しいツールを追加するには：

  1. src/config.ts にツール定義を追加
  2. src/tools.ts に実装を追加
  3. 実装を implementTools オブジェクトに登録

ライセンス

このプロジェクトは MITライセンス の下で公開されています。