AWS MCP

AWS MCP

Model Context Protocol（MCP） サーバーです。Claude のような AI アシスタントが AWS 環境とやり取りできるようにします。これにより、会話中に自然言語で AWS リソースを照会、管理できます。Amazon Q に代わる、より優れた選択肢とお考えください。

機能

• 🔍 自然言語を使って AWS リソースを照会、変更できます
• ☁️ 複数の AWS プロファイルと SSO 認証に対応しています
• 🌐 マルチリージョンに対応しています
• 🔐 認証情報を安全に取り扱います（認証情報が外部サービスに公開されることはなく、ローカルの認証情報が使用されます）
• 🏃‍♂️ AWS 認証情報を使ってローカルで実行します

前提条件

• Node.js
• Claude Desktop
• ローカルで設定済みの AWS 認証情報（~/.aws/ ディレクトリ）

インストール

1. リポジトリをクローンします：

git clone https://github.com/RafalWilinski/aws-mcp
cd aws-mcp

2. 依存関係をインストールします：

pnpm install
# or
npm install

使い方

1. Claude デスクトップアプリを開き、「Settings」→「Developer」→「Edit Config」の順に移動します。

2. claude_desktop_config.json に次のエントリを追加します：

{
  "mcpServers": {
    "aws": {
      "command": "npm", // OR pnpm
      "args": [
        "--silent",
        "--prefix",
        "/Users/<YOUR USERNAME>/aws-mcp",
        "start"
      ]
    }
  }
}

重要：/Users/<YOUR USERNAME>/aws-mcp を、プロジェクトディレクトリの実際のパスに置き換えてください。

3. Claude デスクトップアプリを再起動します。次のように表示されます：

4. AWS プロファイルを選択するか、次のように質問して操作を始めます：
   • 「利用可能な AWS プロファイルを一覧表示して」
   • 「アカウント内のすべての EC2 インスタンスを一覧表示して」
   • 「サイズとともに S3 バケットを表示して」
   • 「us-east-1 にデプロイされている Lambda 関数は？」
   • 「すべての ECS クラスターとそのサービスを一覧表示して」

nvm を使用する場合

まずソースからビルドし、次の設定を追加します：

{
  "mcpServers": {
    "aws": {
      "command": "/Users/<USERNAME>/.nvm/versions/node/v20.10.0/bin/node",
      "args": [
        "<WORKSPACE_PATH>/aws-mcp/node_modules/tsx/dist/cli.mjs",
        "<WORKSPACE_PATH>/aws-mcp/index.ts",
        "--prefix",
        "<WORKSPACE_PATH>/aws-mcp",
        "start"
      ]
    }
  }
}

トラブルシューティング

ログを確認するには：

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-aws.log
# or
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

開発中の機能

• MFA サポート
• SSO 認証情報をキャッシュして、頻繁に更新されないようにする