null
A Model Context Protocol server implementation for operations on AWS resources
Overview
What is MCP Server AWS?
MCP Server AWS is a Model Context Protocol server implementation designed to facilitate operations on AWS resources. This server acts as a bridge between applications and AWS services, allowing developers to manage and interact with various AWS resources seamlessly. By utilizing the Model Context Protocol, it ensures that operations are performed in a structured and efficient manner, enhancing the overall user experience.
Features of MCP Server AWS
- Seamless Integration: MCP Server AWS integrates effortlessly with various AWS services, enabling users to manage resources without the need for extensive configuration.
- Scalability: Designed to handle a growing number of requests, it scales efficiently to meet the demands of applications as they grow.
- Robust Security: Incorporates best practices for security, ensuring that data and operations are protected against unauthorized access.
- User-Friendly Interface: Provides a straightforward interface for developers, making it easy to perform operations on AWS resources.
- Open Source: Being an open-source project, it allows developers to contribute and enhance its capabilities, fostering a community-driven approach to development.
How to Use MCP Server AWS
- Installation: Begin by cloning the repository from GitHub and following the installation instructions provided in the documentation.
- Configuration: Configure the server settings to connect to your AWS account. This includes setting up access keys and permissions.
- Deploying the Server: Once configured, deploy the server on your preferred environment, whether it's locally or on a cloud platform.
- Performing Operations: Use the provided API endpoints to perform operations on AWS resources. The documentation includes examples and use cases to help you get started.
- Monitoring and Maintenance: Regularly monitor the server's performance and update it as necessary to incorporate new features and security patches.
Frequently Asked Questions
Q1: What programming languages are supported by MCP Server AWS?
A1: MCP Server AWS is primarily built using JavaScript and Node.js, making it accessible for developers familiar with these technologies.
Q2: Is there a cost associated with using MCP Server AWS?
A2: No, MCP Server AWS is an open-source project, which means it is free to use. However, users may incur costs associated with the AWS resources they utilize.
Q3: Can I contribute to the MCP Server AWS project?
A3: Absolutely! Contributions are welcome. You can submit issues, feature requests, or pull requests on the GitHub repository.
Q4: How does MCP Server AWS handle security?
A4: The server follows best practices for security, including the use of IAM roles and policies to restrict access to AWS resources. Additionally, it supports encryption for data in transit and at rest.
Q5: Where can I find the documentation for MCP Server AWS?
A5: The documentation is available in the GitHub repository, providing comprehensive guides on installation, configuration, and usage.
Details
AWS MCP Server
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.
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
- Clone this repository.
- 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 tous-east-1
) - Default AWS credential chain (set up via AWS CLI with
aws configure
)
- 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"
]
}
}
- Install and open the Claude desktop app.
- 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
Server Config
{
"mcpServers": {
"mcp-server-aws": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--rishikavikondala--mcp-server-aws--mcp-server-aws",
"mcp-server-aws"
],
"env": {
"AWS_ACCESS_KEY_ID": "AWS_ACCESS_KEY_ID",
"AWS_SECRET_ACCESS_KEY": "AWS_SECRET_ACCESS_KEY",
"AWS_REGION": "AWS_REGION"
}
}
}
}