AWS Resource Manager MCP server for AI agents

The AWS MCP Server is a Model Context Protocol implementation allowing Claude and other compatible AI models to work with AWS services, specifically S3 and DynamoDB. It enables authorized AI assistants to create buckets, upload files, manage database tables, and perform other AWS operations on your behalf when properly configured.

Installation

Option 1: Quick Install via Smithery

The fastest way to install AWS MCP Server for Claude Desktop is through Smithery:

npx -y @smithery/cli install mcp-server-aws --client claude

Option 2: Manual Installation

For more control over the installation process, follow these steps:

Clone the repository:

git clone https://github.com/your-username/mcp-server-aws.git
cd mcp-server-aws

Configure AWS credentials using one of these methods:

Environment Variables:

export AWS_ACCESS_KEY_ID="your-access-key"
export AWS_SECRET_ACCESS_KEY="your-secret-key"
export AWS_REGION="us-east-1"  # Optional, defaults to us-east-1

AWS CLI Configuration:
```
aws configure
```
Then enter your credentials when prompted.

Update Claude Desktop configuration file:

On macOS:

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows:

notepad %APPDATA%/Claude/claude_desktop_config.json

Add the following to your configuration file:

"mcpServers": {
  "mcp-server-aws": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/repo/mcp-server-aws",
      "run",
      "mcp-server-aws"
    ]
  }
}

Install and open the Claude desktop app from claude.ai/download.

Using the AWS MCP Server

Once installed, Claude can perform AWS operations on your behalf. Here are some example prompts to get started:

S3 Operations Examples

Creating a bucket:

Can you create an S3 bucket for me called "my-test-bucket-2023"?

Uploading a file:

Please upload this text to S3 in my-test-bucket-2023 with the filename hello.txt:
Hello world! This is a test file.

Listing bucket contents:

What files do I have in my my-test-bucket-2023 bucket?

Reading file contents:

Can you show me the contents of hello.txt in my-test-bucket-2023?

DynamoDB Operations Examples

Creating a table:

Create a DynamoDB table called "Users" with a primary key of "user_id" (string) and a sort key of "signup_date" (number).

Adding an item:

Add a new user to my Users table with user_id "user123", signup_date 1678942800, name "Jane Smith", and email "[email protected]".

Querying data:

Query the Users table for all items with user_id "user123".

Scanning a table:

Scan the Users table and show me all items.

Troubleshooting

If you encounter issues:

Verify your AWS credentials are correctly configured and have appropriate permissions for S3 and DynamoDB.
Check the Claude desktop app for error messages.
Use the MCP debugging tools as described in the MCP documentation.
Try a simple operation first, like listing S3 buckets, to verify basic functionality.

Supported Operations

S3 Operations

Create, list, and delete buckets
Upload, list, read, and delete objects

DynamoDB Operations

Table operations: create, describe, update, and delete tables
Item operations: put, get, update, delete, query, and scan items
Batch operations: batch get, batch write, and execute multiple PartiQL statements
TTL operations: describe and update TTL settings

All operations are automatically logged and can be accessed through the audit://aws-operations resource endpoint.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "mcp-server-aws" '{"command":"uv","args":["--directory","/path/to/repo/mcp-server-aws","run","mcp-server-aws"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "mcp-server-aws": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/repo/mcp-server-aws",
                "run",
                "mcp-server-aws"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "mcp-server-aws": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/repo/mcp-server-aws",
                "run",
                "mcp-server-aws"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect