モデルコンテキストプロトコル(MCP)サーバーで、ClaudeのようなAIアシスタントがAWS環境とやり取りできるようにします。これにより、会話中の自然言語クエリやAWSリソースの管理が可能になります。より良いAmazon Qの代替案を考えてみてください。

特徴

• 🔍 自然言語を用いたAWSリソースのクエリおよび変更
• ☁️ 複数のAWSプロファイルおよびSSO認証のサポート
• 🌐 マルチリージョン対応
• 🔐 安全な認証情報処理(認証情報は外部サービスに公開されず、ローカル認証情報が使用されます)
• 🏃 ♂️ AWS認証情報を使ったローカル実行

前提条件

• Node.js
• クロードデスクトップ
• ローカルに設定されたAWS認証情報(~/.aws/ディレクトリ)

設置

1. リポジトリのクローン:

2. 依存関係のインストール:

使用法

1. Claudeデスクトップアプリを開き、設定 -> 開発者 -> 設定編集

2. 以下の項目をclaude_desktop_config.jsonに追加します:

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

3. Claudeデスクトップアプリを再起動する。こちらをご覧ください:

4. まずAWSのプロファイルを選択するか、以下を尋ねてアクションに切り替えてください:

• 「利用可能なAWSプロファイル一覧」
• 「私のアカウント内のすべてのEC2インスタンスをリストアップ」

AWS MCP

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your AWS environment. This allows for natural language querying and management of your AWS resources during conversations. Think of better Amazon Q alternative.

Features

• 🔍 Query and modify AWS resources using natural language
• ☁️ Support for multiple AWS profiles and SSO authentication
• 🌐 Multi-region support
• 🔐 Secure credential handling (no credentials are exposed to external services, your local credentials are used)
• 🏃‍♂️ Local execution with your AWS credentials

Prerequisites

• Node.js
• Claude Desktop
• AWS credentials configured locally (~/.aws/ directory)

Installation

1. Clone the repository:

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

2. Install dependencies:

pnpm install
# or
npm install

Usage

1. Open Claude desktop app and go to Settings -> Developer -> Edit Config

2. Add the following entry to your claude_desktop_config.json:

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

Important: Replace /Users//aws-mcp with the actual path to your project directory.

3. Restart Claude desktop app. You should see this:

4. Start by selecting an AWS profile or jump to action by asking:
   • “List available AWS profiles”
   • “List all EC2 instances in my account”
   • “Show me S3 buckets with their sizes”
   • “What Lambda functions are deployed in us-east-1?”
   • “List all ECS clusters and their services”

Using with nvm

Build from source first and add following config:

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

Troubleshooting

To see logs:

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

Features in Development

• [ ] MFA support
• [ ] Cache SSO credentials to prevent from refreshing them too eagerly