mcp-server-aws

MCP.Pizza Chef: rishikavikondala

The mcp-server-aws is a Model Context Protocol server implementation designed to facilitate operations on AWS resources, specifically supporting S3 and DynamoDB services. It enables real-time, structured interaction with AWS environments through the MCP framework, allowing LLMs to perform and manage cloud resource tasks efficiently. All AWS operations executed via this server are automatically logged and accessible through a dedicated audit resource endpoint, ensuring transparency and traceability. This server is recognized as a community contribution within the MCP ecosystem and integrates smoothly with tools like the Claude desktop app, enhancing AI-driven cloud management workflows.

Use This MCP server To

Manage AWS S3 buckets and objects programmatically Perform DynamoDB table operations via LLMs Audit AWS resource operations automatically Integrate AWS resource control into AI workflows Enable real-time AWS environment interaction for agents

README

AWS MCP Server

smithery badge

A Model Context Protocol server implementation for AWS operations that currently supports S3 and DynamoDB services. All operations are automatically logged and can be accessed through the audit://aws-operations resource endpoint.

AWS Server MCP server

See a demo video here.

Listed as a Community Server within the MCP servers repository.

Running locally with the Claude desktop app

Installing via Smithery

To install AWS MCP Server for Claude Desktop automatically via Smithery:

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

Manual Installation

  1. Clone this repository.
  2. Set up your AWS credentials via one of the two methods below. Note that this server requires an IAM user with RW permissions for your AWS account for S3 and DynamoDB.
  • Environment variables: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION (defaults to us-east-1)
  • Default AWS credential chain (set up via AWS CLI with aws configure)
  1. Add the following to your claude_desktop_config.json file:
  • On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • On Windows: %APPDATA%/Claude/claude_desktop_config.json
"mcpServers": {
  "mcp-server-aws": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/repo/mcp-server-aws",
      "run",
      "mcp-server-aws"
    ]
  }
}
  1. Install and open the Claude desktop app.
  2. Try asking Claude to do a read/write operation of some sort to confirm the setup (e.g. create an S3 bucket and give it a random name). If there are issues, use the Debugging tools provided in the MCP documentation here.

Available Tools

S3 Operations

  • s3_bucket_create: Create a new S3 bucket
  • s3_bucket_list: List all S3 buckets
  • s3_bucket_delete: Delete an S3 bucket
  • s3_object_upload: Upload an object to S3
  • s3_object_delete: Delete an object from S3
  • s3_object_list: List objects in an S3 bucket
  • s3_object_read: Read an object's content from S3

DynamoDB Operations

Table Operations

  • dynamodb_table_create: Create a new DynamoDB table
  • dynamodb_table_describe: Get details about a DynamoDB table
  • dynamodb_table_delete: Delete a DynamoDB table
  • dynamodb_table_update: Update a DynamoDB table

Item Operations

  • 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

Batch Operations

  • 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

TTL Operations

  • dynamodb_describe_ttl: Get the TTL settings for a table
  • dynamodb_update_ttl: Update the TTL settings for a table

mcp-server-aws FAQ

How do I install the mcp-server-aws locally?
You can install it via Smithery for seamless integration with the Claude desktop app or run it directly from the GitHub repository following the provided instructions.
Which AWS services does mcp-server-aws currently support?
It currently supports operations on AWS S3 and DynamoDB services.
How are AWS operations logged in mcp-server-aws?
All operations are automatically logged and accessible through the audit://aws-operations resource endpoint for transparency and review.
Can mcp-server-aws be used with multiple LLM providers?
Yes, it is compatible with various LLMs including OpenAI, Anthropic Claude, and Google Gemini through the MCP protocol.
Is mcp-server-aws officially supported or community maintained?
It is listed as a community server within the MCP servers repository, maintained by contributors in the MCP ecosystem.
Does mcp-server-aws support secure and scoped access to AWS resources?
Yes, it follows MCP principles ensuring secure, scoped, and observable interactions with AWS resources.
Where can I find a demo or example usage of mcp-server-aws?
A demo video is available on Loom, linked in the GitHub readme for practical insights.
Can I extend mcp-server-aws to support other AWS services?
While currently focused on S3 and DynamoDB, the server architecture allows for extension to additional AWS services with development effort.