Open source MCP servers for AWS

A suite of specialized MCP servers that help you get the most out of AWS, wherever you use MCP.

[!TIP] The Agent Toolkit for AWS is now live! The Agent Toolkit for AWS is the successor to the MCP servers, plugins, and skills available on AWS Labs, and was informed by feedback from customers like you. If you're building production software using coding agents or building agents for your own customers, we recommend Agent Toolkit for AWS. It includes IAM condition keys to distinguish agent actions from human ones, CloudWatch and CloudTrail visibility, and skills that have been evaluated for accuracy and effectiveness. This repo continues to work and accept contributions. Over time, the most useful projects here will move into Agent Toolkit for AWS.

Open source MCP servers for AWS

What is the Model Context Protocol (MCP) and how does it work with MCP Servers for AWS?

The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.

— Model Context Protocol README

An MCP Server is a lightweight program that exposes specific capabilities through the standardized Model Context Protocol. Host applications (such as chatbots, IDEs, and other AI tools) have MCP clients that maintain 1:1 connections with MCP servers. Common MCP clients include agentic AI coding assistants (like Kiro, Cline, Cursor, Windsurf) as well as chatbot applications like Claude Desktop, with more clients coming soon. MCP servers can access local data sources and remote services to provide additional context that improves the generated outputs from the models.

MCP Servers for AWS use this protocol to provide AI applications access to AWS documentation, contextual guidance, and best practices. Through the standardized MCP client-server architecture, AWS capabilities become an intelligent extension of your development environment or AI application.

MCP Servers for AWS enable enhanced cloud-native development, infrastructure management, and development workflows—making AI-assisted cloud computing more accessible and efficient.

The Model Context Protocol is an open source project run by Anthropic, PBC. and open to contributions from the entire community. For more information on MCP, you can find further documentation here

Open source MCP servers for AWS Transport Mechanisms

Supported transport mechanisms

The MCP protocol currently defines two standard transport mechanisms for client-server communication:

stdio, communication over standard in and standard out
streamable HTTP

The MCP servers in this repository are designed to support stdio only.

You are responsible for ensuring that your use of these servers comply with the terms governing them, and any laws, rules, regulations, policies, or standards that apply to you.

Server Sent Events Support Removal

Important Notice: On May 26th, 2025, Server Sent Events (SSE) support was removed from all MCP servers in their latest major versions. This change aligns with the Model Context Protocol specification's backwards compatibility guidelines.

We are actively working towards supporting Streamable HTTP, which will provide improved transport capabilities for future versions.

For applications still requiring SSE support, please use the previous major version of the respective MCP server until you can migrate to alternative transport methods.

Why MCP Servers for AWS?

MCP servers enhance the capabilities of foundation models (FMs) in several key ways:

Improved Output Quality: By providing relevant information directly in the model's context, MCP servers significantly improve model responses for specialized domains like AWS services. This approach reduces hallucinations, provides more accurate technical details, enables more precise code generation, and ensures recommendations align with current AWS best practices and service capabilities.
Access to Latest Documentation: FMs may not have knowledge of recent releases, APIs, or SDKs. MCP servers bridge this gap by pulling in up-to-date documentation, ensuring your AI assistant always works with the latest AWS capabilities.
Workflow Automation: MCP servers convert common workflows into tools that foundation models can use directly. Whether it's CDK, Terraform, or other AWS-specific workflows, these tools enable AI assistants to perform complex tasks with greater accuracy and efficiency.
Specialized Domain Knowledge: MCP servers provide deep, contextual knowledge about AWS services that might not be fully represented in foundation models' training data, enabling more accurate and helpful responses for cloud development tasks.

Available MCP Servers: Quick Installation

Get started quickly with one-click installation buttons for popular MCP clients. Click the buttons below to install servers directly in Cursor or VS Code:

🚀 Getting Started with AWS

For AWS interactions, we recommend starting with:

Server Name	Description	Install
AWS MCP Server (in preview)	Start here for secure, auditable AWS interactions! This remote, managed MCP server is hosted by AWS and combines comprehensive AWS API support with access to the latest AWS documentation, API references, What's New posts, and Getting Started information. Features pre-built Agent SOPs that follow AWS best practices, helping agents complete complex multi-step AWS tasks reliably. Built with safety and control in mind: syntactically validated API calls, IAM-based permissions with zero credential exposure, and complete CloudTrail audit logging. Access all AWS services for managing infrastructure, exploring resources, and executing AWS operations with full transparency and traceability. Read more

Browse by What You're Building

📚 Real-time access to official AWS documentation

Server Name	Description	Install
AWS Knowledge MCP Server	A remote, fully-managed MCP server hosted by AWS that provides access to the latest AWS docs, API references, What's New Posts, Getting Started information, Builder Center, Blog posts, Architectural references, and Well-Architected guidance.
AWS Documentation MCP Server	Get latest AWS docs and API references

🏗️ Infrastructure & Deployment

Build, deploy, and manage cloud infrastructure with Infrastructure as Code best practices.

Server Name	Description	Install
AWS IaC MCP Server	Complete Infrastructure as Code toolkit with CloudFormation documentation access, CDK best practices guidance, construct examples, security validation, and deployment troubleshooting
AWS Cloud Control API MCP Server ⚠️ DEPRECATED	Direct AWS resource management with security scanning and best practices (Use AWS IaC MCP Server instead)

Container Platforms

Server Name	Description	Install
Amazon EKS MCP Server	Kubernetes cluster management and application deployment
Amazon ECS MCP Server	Container orchestration and ECS application deployment
Finch MCP Server	Local container building with ECR integration

Serverless & Functions

Server Name	Description	Install
AWS Serverless MCP Server	Complete serverless application lifecycle with SAM CLI
AWS Lambda Tool MCP Server	Execute Lambda functions as AI tools for private resource access

Migration & Modernization

Server Name	Description	Install
AWS Transform MCP Server	Manage AWS Transform workspaces, jobs, connectors, HITL tasks, and artifacts for mainframe, VMware, .NET, and custom code transformations

Support

Server Name	Description	Install
AWS Support MCP Server	Help users create and manage AWS Support cases

🤖 AI & Machine Learning

Enhance AI applications with knowledge retrieval, content generation, and ML capabilities

Server Name	Description	Install
Amazon Bedrock Knowledge Bases Retrieval MCP Server	Query enterprise knowledge bases with citation support
Amazon Kendra Index MCP Server	Enterprise search and RAG enhancement
Amazon Q Business MCP Server	AI assistant for your ingested content with anonymous access
Amazon Q Index MCP Server	Data accessors to search through enterprise's Q index
AWS Bedrock Custom Model Import MCP Server	Manage custom models in Bedrock for on-demand inference
AWS Bedrock AgentCore MCP Server	Provides comprehensive documentation access on AgentCore platform services, APIs, and best practices
Amazon Translate MCP Server	Neural machine translation across 75+ languages with batch processing and custom terminology
Amazon SageMaker AI MCP Server	SageMaker AI resource management and model development
Registry of Open Data (RODA) MCP Server	Discover, explore, and preview open datasets on AWS

📊 Data & Analytics

Work with databases, caching systems, and data processing workflows.

SQL & NoSQL Databases

Server Name	Description	Install
Amazon DynamoDB MCP Server	DynamoDB expert design guidance and data modeling assistance
Amazon Aurora PostgreSQL MCP Server	PostgreSQL database operations via RDS Data API
Amazon Aurora MySQL MCP Server	MySQL database operations via RDS Data API
Amazon Aurora DSQL MCP Server	Distributed SQL with PostgreSQL compatibility
Amazon DocumentDB MCP Server	MongoDB-compatible document database operations
Amazon Neptune MCP Server	Graph database queries with openCypher and Gremlin
Amazon Keyspaces MCP Server	Apache Cassandra-compatible operations
Amazon Timestream for InfluxDB MCP Server	Time-series database operations and InfluxDB compatibility
AWS S3 Tables MCP Server	Manage S3 Tables for optimized analytics
Amazon Redshift MCP Server	Data warehouse operations and analytics queries
Amazon RDS Oracle MCP Server	Oracle Database operations via Secrets Manager authentication
AWS IoT SiteWise MCP Server	Industrial IoT asset management, data ingestion, and analytics
Amazon RDS MSSQL MCP Server	SQL Server database operations via RDS Data API

Search & Analytics

Amazon OpenSearch MCP Server - OpenSearch powered search, Analytics, and Observability

Backend API Providers

Server Name	Description	Install
AWS AppSync MCP Server	Manage and Interact with application backends powered by AWS AppSync

Caching & Performance

Server Name	Description	Install
Amazon ElastiCache MCP Server	Complete ElastiCache control plane operations
Amazon ElastiCache / MemoryDB for Valkey MCP Server	Advanced data structures and caching with Valkey
Amazon ElastiCache for Memcached MCP Server	High-speed caching with Memcached protocol

Open Data

Server Name	Description	Install
Registry of Open Data (RODA) MCP Server	Discover, explore, and preview open datasets on AWS

🛠️ Developer Tools & Support

Accelerate development with code analysis, documentation, and testing utilities.

Server Name	Description	Install
AWS IAM MCP Server	Comprehensive IAM user, role, group, and policy management with security best practices
AWS Security Agent MCP Server	Automated security scanning, penetration testing, and remediation using AWS Security Agent
OpenAPI MCP Server	Dynamic API integration through OpenAPI specifications

📡 Integration & Messaging

Connect systems with messaging, workflows, and location services.

Server Name	Description	Install
Amazon SNS / SQS MCP Server	Event-driven messaging and queue management
Amazon MQ MCP Server	Message broker management for RabbitMQ and ActiveMQ
AWS Step Functions Tool MCP Server	Execute complex workflows and business processes
Amazon Location Service MCP Server	Place search, geocoding, and route optimization
OpenAPI MCP Server	Dynamic API integration through OpenAPI specifications

💰 Cost & Operations

Monitor, optimize, and manage your AWS infrastructure and costs.

Server Name	Description	Install
AWS Pricing MCP Server	AWS service pricing and cost estimates
Amazon CloudWatch MCP Server	Metrics, Alarms, and Logs analysis and operational troubleshooting
AWS Managed Prometheus MCP Server	Prometheus-compatible operations
AWS Billing and Cost Management MCP Server	Billing and cost management for chargeable and Proforma billing

🧬 Healthcare & Lifesciences

Interact with AWS HealthAI services.

Server Name	Description	Install
AWS HealthOmics MCP Server	Generate, run, debug and optimize lifescience workflows
AWS HealthImaging MCP Server	Comprehensive medical imaging data lifecycle management with 21 tools for DICOM operations, datastore management, and automated discovery
AWS HealthLake MCP Server	Create, manage, search, and optimize FHIR healthcare data workflows with comprehensive AWS HealthLake integration, featuring automated resource discovery, advanced search capabilities, patient record management, and seamless import/export operations.
Registry of Open Data (RODA) MCP Server	Discover, explore, and preview open datasets on AWS

Browse by How You're Working

👨‍💻 Vibe Coding & Development

AI coding assistants like Kiro, Cline, Cursor, and Claude Code helping you build faster

Workshop: Check out the Vibe Coding with AWS MCP Servers workshop for hands-on guidance and examples.

Core Development Workflow

Server Name	Description	Install
AWS API MCP Server	Start here for general AWS interactions! Comprehensive AWS API support with command validation, security controls, and access to all AWS services. Perfect for managing infrastructure, exploring resources, and executing AWS operations through natural language.
AWS Knowledge MCP Server	A remote, fully-managed MCP server hosted by AWS that provides access to the latest AWS docs, API references, What's New Posts, Getting Started information, Builder Center, Blog posts, Architectural references, and Well-Architected guidance.
AWS Documentation MCP Server	Get latest AWS docs and API references

Infrastructure as Code

Server Name	Description	Install
AWS IaC MCP Server	Complete Infrastructure as Code toolkit with CloudFormation documentation access, CDK best practices guidance, construct examples, security validation, and deployment troubleshooting
AWS Cloud Control API MCP Server ⚠️ DEPRECATED	Direct AWS resource management with security scanning and best practices (Use AWS IaC MCP Server instead)

Application Development

Server Name	Description	Install
OpenAPI MCP Server	Dynamic API integration through OpenAPI specifications

Container & Serverless Development

Server Name	Description	Install
Amazon SageMaker AI MCP Server	SageMaker AI resource management and model development
Amazon EKS MCP Server	Kubernetes cluster management and app deployment
Amazon ECS MCP Server	Containerize and deploy applications to ECS
Finch MCP Server	Local container building with ECR push
AWS Serverless MCP Server	Full serverless app lifecycle with SAM CLI

Testing & Data

Server Name	Description	Install

Lifesciences Workflow Development

Server Name	Description	Install
AWS HealthOmics MCP Server	Generate, run, debug and optimize lifescience workflows

Healthcare Data Management

Server Name	Description	Install
AWS HealthLake MCP Server	Create, manage, search, and optimize FHIR healthcare data workflows with comprehensive AWS HealthLake integration, featuring automated resource discovery, advanced search capabilities, patient record management, and seamless import/export operations.

💬 Conversational Assistants

Customer-facing chatbots, business agents, and interactive Q&A systems

Knowledge & Search

Server Name	Description	Install
Amazon Bedrock Knowledge Bases Retrieval MCP Server	Query enterprise knowledge bases with citation support
Amazon Kendra Index MCP Server	Enterprise search and RAG enhancement
Amazon Q Business MCP Server	AI assistant for your ingested content with anonymous access
Amazon Q Index MCP Server	Data accessors to search through enterprise's Q index
AWS Documentation MCP Server	Get latest AWS docs and API references

Content Processing & Generation

Server Name	Description	Install
Document Loader MCP Server	Parse and extract content from PDF, DOCX, XLSX, PPTX, and image files
Amazon Translate MCP Server	Neural machine translation across 75+ languages with batch processing and custom terminology

Business Services

Server Name	Description	Install
Amazon Location Service MCP Server	Location search, geocoding, and business hours
AWS Pricing MCP Server	AWS service pricing and cost estimates

🤖 Autonomous Background Agents

Headless automation, ETL pipelines, and operational systems

Data Operations & ETL

Server Name	Description	Install
AWS Data Processing MCP Server	Comprehensive data processing tools and real-time pipeline visibility across AWS Glue, Amazon EMR-EC2, and Amazon Athena
Amazon DynamoDB MCP Server	Complete DynamoDB operations and table management
Amazon Aurora PostgreSQL MCP Server	PostgreSQL database operations via RDS Data API
Amazon Aurora MySQL MCP Server	MySQL database operations via RDS Data API
Amazon Aurora DSQL MCP Server	Distributed SQL with PostgreSQL compatibility
Amazon DocumentDB MCP Server	MongoDB-compatible document database operations
Amazon Neptune MCP Server	Graph database queries with openCypher and Gremlin
Amazon Keyspaces MCP Server	Apache Cassandra-compatible operations
Amazon Timestream for InfluxDB MCP Server	Time-series database operations and InfluxDB compatibility
Amazon RDS MSSQL MCP Server	SQL Server database operations via RDS Data API

| Amazon RDS Oracle MCP Server | Oracle Database operations via Secrets Manager authentication |

|

Caching & Performance

Server Name	Description	Install
Amazon ElastiCache / MemoryDB for Valkey MCP Server	Advanced data structures and caching with Valkey
Amazon ElastiCache for Memcached MCP Server	High-speed caching with Memcached protocol

Workflow & Integration

Server Name	Description	Install
AWS Lambda Tool MCP Server	Execute Lambda functions as AI tools for private resource access
AWS Step Functions Tool MCP Server	Execute complex workflows and business processes
Amazon SNS/SQS MCP Server	Event-driven messaging and queue management
Amazon MQ MCP Server	Message broker management for RabbitMQ and ActiveMQ

Operations & Monitoring

Server Name	Description	Install
Amazon CloudWatch MCP Server	Metrics, Alarms, and Logs analysis and operational troubleshooting
Amazon CloudWatch Application Signals MCP Server	Application monitoring and performance insights
AWS Managed Prometheus MCP Server	Prometheus-compatible operations and monitoring
AWS Security Agent MCP Server	Automated security scanning, penetration testing, and remediation using AWS Security Agent
AWS Well-Architected Security Assessment Tool MCP Server	Assess AWS environments against the Well-Architected Framework Security Pillar
AWS CloudTrail MCP Server	CloudTrail events querying and analysis
AWS Systems Manager for SAP MCP Server	Manage, monitor, and operate SAP applications on AWS with health checks, configuration validation, and scheduling

MCP AWS Lambda Handler Module

A Python library for creating serverless HTTP handlers for the Model Context Protocol (MCP) using AWS Lambda. This module provides a flexible framework for building MCP HTTP endpoints with pluggable session management, including built-in DynamoDB support.

Features:

Easy serverless MCP HTTP handler creation using AWS Lambda
Pluggable session management system
Built-in DynamoDB session backend support
Customizable authentication and authorization
Example implementations and tests

See src/mcp-lambda-handler/README.md for full usage, installation, and development instructions.

When to use Local vs Remote MCP Servers?

MCP servers can be run either locally on your development machine or remotely on the cloud. Here's when to use each approach:

Local MCP Servers

Development & Testing: Perfect for local development, testing, and debugging
Offline Work: Continue working when internet connectivity is limited
Data Privacy: Keep sensitive data and credentials on your local machine
Low Latency: Minimal network overhead for faster response times
Resource Control: Direct control over server resources and configuration

Remote MCP Servers

Team Collaboration: Share consistent server configurations across your team
Resource Intensive Tasks: Offload heavy processing to dedicated cloud resources
Always Available: Access your MCP servers from anywhere, any device
Automatic Updates: Get the latest features and security patches automatically
Scalability: Easily handle varying workloads without local resource constraints
Security: Centralized security controls with IAM-based permissions and zero credential exposure
Governance: Comprehensive audit logging and compliance monitoring for enterprise-grade governance

Note: Some MCP servers, like the official AWS MCP server (in preview) and AWS Knowledge MCP, are provided as fully managed services by AWS. These AWS-managed remote servers require no setup or infrastructure management on your part - just connect and start using them.

Use Cases for the Servers

For example, you can use the AWS Documentation MCP Server to help your AI assistant research and generate up-to-date code for any AWS service, like Amazon Bedrock Inline agents. Alternatively, you could use the CDK MCP Server or the Terraform MCP Server to have your AI assistant create infrastructure-as-code implementations that use the latest APIs and follow AWS best practices. With the AWS Pricing MCP Server, you could ask "What would be the estimated monthly cost for this CDK project before I deploy it?" or "Can you help me understand the potential AWS service expenses for this infrastructure design?" and receive detailed cost estimations and budget planning insights. The Valkey MCP Server enables natural language interaction with Valkey data stores, allowing AI assistants to efficiently manage data operations through a simple conversational interface.

Installation and Setup

Each server has specific installation instructions with one-click installs for Kiro, Cursor, and VSCode. Generally, you can:

Install uv from Astral
Install Python using uv python install 3.10
Configure AWS credentials with access to required services
Add the server to your MCP client configuration

Example configuration for Kiro MCP settings (~/.kiro/settings/mcp.json):

For macOS/Linux

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "command": "uvx",
      "args": [
        "awslabs.core-mcp-server@latest"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

See individual server READMEs for specific requirements and configuration options.

For Windows

When configuring MCP servers on Windows, you'll need to use a slightly different configuration format:

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.core-mcp-server@latest",
        "awslabs.core-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

If you have problems with MCP configuration or want to check if the appropriate parameters are in place, you can try the following:

shell

# Run MCP server manually with timeout 15s
$ timeout 15s uv tool run <MCP Name> <args> 2>&1 || echo "Command completed or timed out"

# Example (Aurora MySQL MCP Server)
$ timeout 15s uv tool run awslabs.mysql-mcp-server --resource_arn <Your Resource ARN> --secret_arn <Your Secret ARN> ... 2>&1 || echo "Command completed or timed out"

# If the arguments are not set appropriately, you may see the following message:
usage: awslabs.mysql-mcp-server [-h] --resource_arn RESOURCE_ARN --secret_arn SECRET_ARN --database DATABASE
                                --region REGION --readonly READONLY
awslabs.mysql-mcp-server: error: the following arguments are required: --resource_arn, --secret_arn, --database, --region, --readonly

Note about performance when using uvx "@latest" suffix:

Using the "@latest" suffix checks and downloads the latest MCP server package from pypi every time you start your MCP clients, but it comes with a cost of increased initial load times. If you want to minimize the initial load time, remove "@latest" and manage your uv cache yourself using one of these approaches:

uv cache clean <tool>: where {tool} is the mcp server you want to delete from cache and install again (e.g.: "awslabs.lambda-tool-mcp-server") (remember to remove the '<>').
uvx <tool>@latest: this will refresh the tool with the latest version and add it to the uv cache.

Running MCP servers in containers

Docker images for each MCP server are published to the public AWS ECR registry.

This example uses docker with the "awslabs.aws-documentation-mcp-server and can be repeated for each MCP server

Optionally save sensitive environmental variables in a file:

Code

# contents of a .env file with fictitious AWS temporary credentials
AWS_ACCESS_KEY_ID=ASIAIOSFODNN7EXAMPLE
AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
AWS_SESSION_TOKEN=AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk

Use the docker options: --env, --env-file, and --volume as needed because the "env": {} are not available within the container.

config.json

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--interactive",
        "--env",
        "FASTMCP_LOG_LEVEL=ERROR",
        "--env",
        "AWS_REGION=us-east-1",
        "--env-file",
        "/full/path/to/.env",
        "--volume",
        "/full/path/to/.aws:/app/.aws",
        "public.ecr.aws/awslabs-mcp/awslabs/aws-documentation-mcp-server:latest"
      ],
      "env": {}
    }
  }
}

For testing local changes you can build and tag the image. You have to update the MCP configuration to use this tag instead of the ECR image.
base
```
cd src/aws-documentation-mcp-server
docker build -t awslabs/aws-documentation-mcp-server .
```

Getting Started with Kiro

Install in Kiro

See the Kiro IDE documentation or the Kiro CLI documentation for details.

In the Kiro IDE:

Navigate Kiro > MCP Servers
Add a new MCP server by clicking the + Add button.
Paste the configuration given below.

For global configuration, edit ~/.kiro/settings/mcp.json. For project-specific configuration, edit .kiro/settings/mcp.json in your project directory.

`~/.kiro/settings/mcp.json`

For macOS/Linux:

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.core-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

For Windows:

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.core-mcp-server@latest",
        "awslabs.core-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Getting Started with Cline and Amazon Bedrock

IMPORTANT: Following these instructions may incur costs and are subject to the Amazon Bedrock Pricing. You are responsible for any associated costs. In addition to selecting the desired model in the Cline settings, ensure you have your selected model (e.g. anthropic.claude-3-7-sonnet) also enabled in Amazon Bedrock. For more information on this, see these AWS docs on enabling model access to Amazon Bedrock Foundation Models (FMs).

Follow the steps above in the Installation and Setup section to install uv from Astral, install Python, and configure AWS credentials with the required services.
If using Visual Studio Code, install the Cline VS Code Extension (or equivalent extension for your preferred IDE). Once installed, click the extension to open it. When prompted, select the tier that you wish. In this case, we will be using Amazon Bedrock, so the free tier of Cline is fine as we will be sending requests using the Amazon Bedrock API instead of the Cline API.

Select the MCP Servers button.

Select the Installed tab, then click Configure MCP Servers to open the cline_mcp_settings.json file.

In the cline_mcp_settings.json file, add your desired MCP servers in the mcpServers object. See the following example that will use some of the current MCP servers that are available in this repository. Ensure you save the file to install the MCP servers.

`cline_mcp_settings.json`

For macOS/Linux:

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.core-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "MCP_SETTINGS_PATH": "path to your mcp settings file"
      }
    }
   }
 }

For Windows:

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.core-mcp-server@latest",
        "awslabs.core-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "MCP_SETTINGS_PATH": "path to your mcp settings file"
      }
    }
  }
}

Once installed, you should see a list of your MCP Servers under the MCP Server Installed tab, and they should have a green slider to show that they are enabled. See the following for an example with two of the possible MCP servers for AWS. Click Done when finished. You should now see the Cline chat interface.

By default, Cline will be set as the API provider, which has limits for the free tier. Next, let's update the API provider to be AWS Bedrock, so we can use the LLMs through Bedrock, which would have billing go through your connected AWS account.
Click the settings gear to open up the Cline settings. Then under API Provider, switch this from Cline to AWS Bedrock and select AWS Profile for the authentication type. As a note, the AWS Credentials option works as well, however it uses a static credentials (Access Key ID and Secret Access Key) instead of temporary credentials that are automatically redistributed when the token expires, so the temporary credentials with an AWS Profile is the more secure and recommended method.

Fill out the configuration based on the existing AWS Profile you wish to use, select the desired AWS Region, and enable cross-region inference.

Next, scroll down on the settings page until you reach the text box that says Custom Instructions. Paste in the following snippet to ensure the mcp-core server is used as the starting point for every prompt:

Code

For every new project, always look at your MCP servers and use mcp-core as the starting point every time. Also after a task completion include the list of MCP servers used in the operation.

Once the custom prompt is pasted in, click Done to return to the chat interface.
Now you can begin asking questions and testing out the functionality of your installed MCP servers. The default option in the chat interface is is Plan which will provide the output for you to take manual action on (e.g. providing you a sample configuration that you copy and paste into a file). However, you can optionally toggle this to Act which will allow Cline to act on your behalf (e.g. searching for content using a web browser, cloning a repository, executing code, etc). You can optionally toggle on the "Auto-approve" section to avoid having to click to approve the suggestions, however we recommend leaving this off during testing, especially if you have the Act toggle selected.

Note: For the best results, please prompt Cline to use the desired MCP server you wish to use. For example, Using the Terraform MCP Server, do...

Getting Started with Cursor

Follow the steps above in the Installation and Setup section to install uv from Astral, install Python, and configure AWS credentials with the required services.
You can place MCP configuration in two locations, depending on your use case:

A. Project Configuration - For tools specific to a project, create a .cursor/mcp.json file in your project directory. - This allows you to define MCP servers that are only available within that specific project.

B. Global Configuration - For tools that you want to use across all projects, create a ~/.cursor/mcp.json file in your home directory. - This makes MCP servers available in all your Cursor workspaces.

`.cursor/mcp.json`

For macOS/Linux:

config.json

 {
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.core-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

For Windows:

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.core-mcp-server@latest",
        "awslabs.core-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Using MCP in Chat The Composer Agent will automatically use any MCP tools that are listed under Available Tools on the MCP settings page if it determines them to be relevant. To prompt tool usage intentionally, please prompt Cursor to use the desired MCP server you wish to use. For example, Using the Terraform MCP Server, do...
Tool Approval By default, when Agent wants to use an MCP tool, it will display a message asking for your approval. You can use the arrow next to the tool name to expand the message and see what arguments the Agent is calling the tool with.

Getting Started with Windsurf

Follow the steps above in the Installation and Setup section to install uv from Astral, install Python, and configure AWS credentials with the required services.
Access MCP Settings
- Navigate to Windsurf - Settings > Advanced Settings or use the Command Palette > Open Windsurf Settings Page
- Look for the "Model Context Protocol (MCP) Servers" section
Add MCP Servers
- Click "Add Server" to add a new MCP server
- You can choose from available templates like GitHub, Puppeteer, PostgreSQL, etc.
- Alternatively, click "Add custom server" to configure your own server
Manual Configuration
- You can also manually edit the MCP configuration file located at ~/.codeium/windsurf/mcp_config.json

`~/.codeium/windsurf/mcp_config.json`

For macOS/Linux:

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.core-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "MCP_SETTINGS_PATH": "path to your mcp settings file"
      }
    }
   }
 }

For Windows:

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.core-mcp-server@latest",
        "awslabs.core-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "MCP_SETTINGS_PATH": "path to your mcp settings file"
      }
    }
  }
}

Getting Started with VS Code

Install in VS Code

Configure MCP servers in VS Code settings or in .vscode/mcp.json (see VS Code MCP docs for more info.):

`.vscode/mcp.json`

For macOS/Linux:

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.core-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

For Windows:

config.json

{
  "mcpServers": {
    "awslabs-core-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.core-mcp-server@latest",
        "awslabs.core-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Getting Started with Claude Code

Install in Claude Code

Configure MCP servers in Claude Code through the CLI or in .mcp.json

Follow the steps above in the Installation and Setup section to install uv from Astral, install Python, and configure AWS credentials with the required services.

Using Claude Code CLI Commands

Claude Code CLI commands to add MCP servers:

bash

# Add core AWS services
claude mcp add aws-api uvx awslabs.aws-api-mcp-server@latest
claude mcp add aws-iac uvx awslabs.aws-iac-mcp-server@latest
claude mcp add aws-docs uvx awslabs.aws-documentation-mcp-server@latest
claude mcp add aws-support uvx awslabs.aws-support-mcp-server@latest
claude mcp add aws-pricing uvx awslabs.aws-pricing-mcp-server@latest

# Add AI/ML and Bedrock services
claude mcp add bedrock-kb uvx awslabs.bedrock-kb-retrieval-mcp-server@latest

# Add data and analytics services
claude mcp add aws-dataprocessing uvx awslabs.aws-dataprocessing-mcp-server@latest
claude mcp add aurora-dsql uvx awslabs.aurora-dsql-mcp-server@latest
claude mcp add valkey uvx awslabs.valkey-mcp-server@latest

# List installed servers
claude mcp list

Manual Configuration (Alternative)

You can also manually configure MCP servers by creating a .mcp.json file in your project root:

`.mcp.json`

For macOS/Linux:

config.json

{
  "mcpServers": {
    "awslabs.aws-iac-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-iac-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    },
    "awslabs.aws-documentation-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_DOCUMENTATION_PARTITION": "aws"
      }
    }
  }
}

Getting Started with fx

Install in fx

fx manages MCP servers from the terminal and stores them in ~/.fx/mcp.json, so they are available in every project.

Follow the steps above in the Installation and Setup section to install uv from Astral, install Python, and configure AWS credentials with the required services.

Using fx CLI commands

bash

# The hosted AWS Knowledge MCP Server needs no credentials
fx mcp add --transport http aws-knowledge https://knowledge-mcp.global.api.aws

# Local servers take the executable and its arguments
fx mcp add aws-api uvx awslabs.aws-api-mcp-server@latest
fx mcp add aws-iac uvx awslabs.aws-iac-mcp-server@latest
fx mcp add aws-iam uvx awslabs.iam-mcp-server@latest

# List configured servers
fx mcp list

Manual configuration (alternative)

Add the servers under the mcp key. fx uses mcp rather than mcpServers, type to select the transport, and a single command array holding the executable and its arguments.

`~/.fx/mcp.json`

config.json

{
  "mcp": {
    "aws-knowledge-mcp-server": {
      "type": "http",
      "url": "https://knowledge-mcp.global.api.aws"
    },
    "awslabs.aws-iac-mcp-server": {
      "type": "local",
      "command": ["uvx", "awslabs.aws-iac-mcp-server@latest"],
      "environment": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

The first launch of a uvx server downloads the package, which can exceed the default startup timeout. Raise it for that server if needed:

json

"startup_timeout_ms": 30000

If a session is already open when you edit the file, run /mcp reload to pick up the change.

Samples

Ready-to-use examples of open source MCP servers for AWS in action are available in the samples directory. These samples provide working code and step-by-step guides to help you get started with each MCP server.

Vibe coding

You can use these MCP servers with your AI coding assistant to vibe code. For tips and tricks on how to improve your vibe coding experience, please refer to our guide.

Additional Resources

Security

See CONTRIBUTING for more information.

Contributing

Big shout out to our awesome contributors! Thank you for making this project better!

Contributions of all kinds are welcome! Check out our contributor guide for more information.

Developer guide

If you want to add a new MCP Server to the library, check out our development guide and be sure to follow our design guidelines.

License

This project is licensed under the Apache-2.0 License.

Disclaimer

Before using an MCP Server, you should consider conducting your own independent assessment to ensure that your use would comply with your own specific security and quality control practices and standards, as well as the laws, rules, and regulations that govern you and your content.

Open source MCP servers for AWS

Table of Contents

What is the Model Context Protocol (MCP) and how does it work with MCP Servers for AWS?

Open source MCP servers for AWS Transport Mechanisms

Supported transport mechanisms

Server Sent Events Support Removal

Why MCP Servers for AWS?

Available MCP Servers: Quick Installation

🚀 Getting Started with AWS

Browse by What You're Building

📚 Real-time access to official AWS documentation

🏗️ Infrastructure & Deployment

Container Platforms

Serverless & Functions

Migration & Modernization

Support

🤖 AI & Machine Learning

📊 Data & Analytics

SQL & NoSQL Databases

Search & Analytics

Backend API Providers

Caching & Performance

Open Data

🛠️ Developer Tools & Support

📡 Integration & Messaging

💰 Cost & Operations

🧬 Healthcare & Lifesciences

Browse by How You're Working

👨‍💻 Vibe Coding & Development

Core Development Workflow

Infrastructure as Code

Application Development

Container & Serverless Development

Testing & Data

Lifesciences Workflow Development

Healthcare Data Management

💬 Conversational Assistants

Knowledge & Search

Content Processing & Generation

Business Services

🤖 Autonomous Background Agents

Data Operations & ETL

Caching & Performance

Workflow & Integration

Operations & Monitoring

MCP AWS Lambda Handler Module

When to use Local vs Remote MCP Servers?

Local MCP Servers

Remote MCP Servers

Use Cases for the Servers

Installation and Setup

For macOS/Linux

For Windows

Running MCP servers in containers

Getting Started with Kiro

~/.kiro/settings/mcp.json

Getting Started with Cline and Amazon Bedrock

cline_mcp_settings.json

Getting Started with Cursor

.cursor/mcp.json

Getting Started with Windsurf

~/.codeium/windsurf/mcp_config.json

Getting Started with VS Code

.vscode/mcp.json

Getting Started with Claude Code

.mcp.json

Getting Started with fx

~/.fx/mcp.json

Samples

Vibe coding

Additional Resources

Security

Contributing

Developer guide

License

Disclaimer

`~/.kiro/settings/mcp.json`

`cline_mcp_settings.json`

`.cursor/mcp.json`

`~/.codeium/windsurf/mcp_config.json`

`.vscode/mcp.json`

`.mcp.json`

`~/.fx/mcp.json`