Claude와 같은 AI 비서가 AWS 환경과 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이를 통해 대화 중 자연어 쿼리와 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