AWS MCP
Talk with your AWS using Claude. Model Context Protocol (MCP) server for AWS. Better Amazon Q alternative.
Overview
AWS MCP (Model Context Protocol) is a server that enables AI assistants like Claude to interact seamlessly with your AWS environment, facilitating natural language querying and management of AWS resources as a better alternative to Amazon Q.
To use AWS MCP, clone the repository, install the dependencies, configure the Claude desktop app by adding the MCP server settings, and then you can start querying AWS resources via natural language commands.
- Natural language querying and modification of AWS resources - Support for multiple AWS profiles and Single Sign-On (SSO) authentication - Multi-region support for AWS services - Secure credential handling, using local AWS credentials without exposing them externally - Local execution with seamless integration using AWS credentials
- Querying details of EC2 instances in a user's AWS account.
- Listing S3 buckets and their sizes easily via natural language.
- Managing multiple AWS profiles and accessing resources across different regions.
Add to your AI client
Use these steps to connect AWS MCP in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"aws-mcp-rafalwilinski": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aws-mcp-rafalwilinski"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"aws-mcp-rafalwilinski": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aws-mcp-rafalwilinski"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"aws-mcp-rafalwilinski": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aws-mcp-rafalwilinski"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"aws-mcp-rafalwilinski": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aws-mcp-rafalwilinski"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"aws-mcp-rafalwilinski": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aws-mcp-rafalwilinski"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"aws-mcp-rafalwilinski": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aws-mcp-rafalwilinski"
]
}
}
}FAQ
Can AWS MCP work with various AWS services?
Yes! AWS MCP can interact with multiple AWS services like EC2, S3, Lambda, and ECS using simple queries.
Do I need special permissions to use AWS MCP?
Yes, you will need proper AWS credentials configured locally to access your resources.
Is there ongoing development for new features?
Yes! Features in development include MFA support and caching SSO credentials.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":457,"uuid":"0b464be5-7c11-4c3e-b7fc-4ef984c70da2","name":"aws-mcp","title":"AWS MCP","description":"Talk with your AWS using Claude. Model Context Protocol (MCP) server for AWS. Better Amazon Q alternative.","avatar_url":"https://avatars.githubusercontent.com/u/3391616?v=4","created_at":"2024-12-19T02:12:27.469Z","updated_at":"2024-12-19T12:39:22.522Z","status":"created","author_name":"RafalWilinski","author_avatar_url":"https://avatars.githubusercontent.com/u/3391616?v=4","tags":"aws,ai,mcp,claude,llm,amazon-q","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/RafalWilinski/aws-mcp","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/RafalWilinski/aws-mcp/raw/main/images/aws-mcp-demo.png","type":null,"metadata":"{\"star\":\"140\",\"license\":\"\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-04 15:53:44\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]