https://github.com/rafalwilinski/aws-mcp
Talk with your AWS using Claude. Model Context Protocol (MCP) server for AWS. Better Amazon Q alternative.
https://github.com/rafalwilinski/aws-mcp
ai amazon-q aws claude llm mcp
Last synced: about 2 hours ago
JSON representation
Talk with your AWS using Claude. Model Context Protocol (MCP) server for AWS. Better Amazon Q alternative.
- Host: GitHub
- URL: https://github.com/rafalwilinski/aws-mcp
- Owner: RafalWilinski
- Created: 2024-12-18T12:15:29.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-04T14:53:47.000Z (7 months ago)
- Last Synced: 2025-03-29T21:02:40.349Z (6 months ago)
- Topics: ai, amazon-q, aws, claude, llm, mcp
- Language: TypeScript
- Homepage: https://rwilinski.ai
- Size: 2.05 MB
- Stars: 222
- Watchers: 6
- Forks: 23
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - Aws MCP - A Model Context Protocol (MCP) server that enables direct interaction with AWS services using the AWS SDK v2, allowing resource management and querying in cloud environments. ([Read more](/details/aws-mcp.md)) `mcp` `aws` `cloud` `resource-management` (Cloud & DevOps MCP Servers)
README
# AWS MCP
A [Model Context Protocol (MCP)](https://www.anthropic.com/news/model-context-protocol) 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](https://nodejs.org/)
- [Claude Desktop](https://claude.ai/download)
- AWS credentials configured locally (`~/.aws/` directory)
## Installation
1. Clone the repository:
```bash
git clone https://github.com/RafalWilinski/aws-mcp
cd aws-mcp
```
2. Install dependencies:
```bash
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`:
```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:
```json
{
"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:
```bash
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
