home / mcp / aws mcp server

AWS MCP Server

Provides AWS operations for S3 and DynamoDB via MCP with auditable logging.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "mcp-mirror-rishikavikondala_mcp-server-aws": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/repo/mcp-server-aws",
        "run",
        "mcp-server-aws"
      ],
      "env": {
        "AWS_REGION": "us-west-2",
        "AWS_ACCESS_KEY_ID": "AKIAEXAMPLEKEY",
        "AWS_SECRET_ACCESS_KEY": "wJalrXUtnFexample"
      }
    }
  }
}

This MCP server provides a Model Context Protocol implementation for AWS operations, enabling you to perform S3 and DynamoDB actions through a unified, auditable interface. It routes requests to AWS services and logs all operations for easy auditing via a dedicated endpoint.

How to use

You interact with the AWS MCP Server from an MCP client to perform AWS operations such as creating and listing S3 buckets, uploading and reading objects, and managing DynamoDB tables and items. All actions are automatically logged and can be accessed through the audit endpoint at audit://aws-operations, giving you a clear record of what happened and when.

How to install

Prerequisites: you will need the Claude desktop app to run MCP servers locally and an IAM user with read/write permissions for S3 and DynamoDB in your AWS account.

1. Clone the MCP server project into a local directory.

2. Configure your AWS credentials. You can use one of these methods:

- Environment variables: set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_REGION (defaults to us-east-1)

- Default AWS credential chain (set up via AWS CLI with aws configure)

3. Add the MCP server configuration to Claude’s config file. On MacOS, place the file at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows, place it at %APPDATA%/Claude/claude_desktop_config.json.

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

Additional setup steps and validation

4. Install and open the Claude desktop app.

5. Validate the setup by instructing Claude to perform a read/write operation, such as creating an S3 bucket with a unique name. If you encounter issues, use the debugging tools provided in the MCP guidance to troubleshoot.

Available tools

s3_bucket_create

Create a new S3 bucket.

s3_bucket_list

List all S3 buckets in your account.

s3_bucket_delete

Delete an S3 bucket.

s3_object_upload

Upload an object to an S3 bucket.

s3_object_delete

Delete an object from an S3 bucket.

s3_object_list

List objects within an S3 bucket.

s3_object_read

Read the contents of an object stored in S3.

dynamodb_table_create

Create a new DynamoDB table.

dynamodb_table_describe

Describe details of a DynamoDB table.

dynamodb_table_delete

Delete a DynamoDB table.

dynamodb_table_update

Update a DynamoDB table.

dynamodb_item_put

Put an item into a DynamoDB table.

dynamodb_item_get

Get an item from a DynamoDB table.

dynamodb_item_update

Update an item in a DynamoDB table.

dynamodb_item_delete

Delete an item from a DynamoDB table.

dynamodb_item_query

Query items in a DynamoDB table.

dynamodb_item_scan

Scan items in a DynamoDB table.

dynamodb_batch_get

Batch get multiple items from DynamoDB tables.

dynamodb_item_batch_write

Batch write operations (put/delete) for DynamoDB items.

dynamodb_batch_execute

Execute multiple PartiQL statements in a batch.

dynamodb_describe_ttl

Describe TTL settings for a DynamoDB table.

dynamodb_update_ttl

Update TTL settings for a DynamoDB table.