AWS MCP Proxy
AWS MCP Proxy Server
What is AWS MCP Proxy?
AWS MCP Proxy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to aws mcp proxy server
AWS MCP Proxy Server
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- AWS MCP Proxy Server
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-proxy-for-awsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use AWS MCP Proxy
The AWS MCP Proxy is an official Amazon proxy server that bridges MCP clients to AWS IAM-authenticated MCP endpoints by automatically signing outbound requests with AWS SigV4. It enables AI assistants like Claude to securely access AWS-hosted MCP servers — such as AWS Bedrock Agent tools, Bedrock Knowledge Bases, or custom Lambda-backed MCP endpoints — without exposing raw credentials in client configurations. Teams managing multiple AWS accounts can use its profile-switching capability to route tool calls across environments within a single session.
Prerequisites
- Python 3.10+ and uv installed (pip install uv)
- AWS credentials configured locally (aws configure or IAM role on EC2/ECS)
- The URL of an AWS IAM-authenticated MCP endpoint to proxy to
- An MCP-compatible client such as Claude Desktop or Claude Code
- Docker (optional, for containerized deployment)
Install the proxy via uvx
Use uvx to run a specific release directly from PyPI without a permanent install. Replace the URL with your AWS-hosted MCP endpoint.
uvx [email protected] https://your-aws-mcp-endpoint.amazonaws.com/mcpConfigure AWS credentials
Ensure your local AWS credentials are set up. The proxy reads standard AWS environment variables or the ~/.aws/credentials file.
export AWS_PROFILE=my-profile
export AWS_REGION=us-east-1
# or configure with:
aws configureRun with service and region flags
Specify the AWS service name for SigV4 signing and the region. Use --read-only to restrict write-capable tools.
uvx [email protected] \
--service bedrock \
--region us-east-1 \
--profile my-profile \
https://your-aws-mcp-endpoint.amazonaws.com/mcpAdd the proxy to your MCP client configuration
Register the proxy as an MCP server in your claude_desktop_config.json, passing the endpoint URL as the first argument.
Verify connectivity
Ask your AI assistant to list available tools. The proxy will sign the request with SigV4 and forward it to the AWS endpoint. A list of tools from the upstream server confirms success.
AWS MCP Proxy Examples
Client configuration
Claude Desktop config that runs the AWS MCP Proxy via uvx, signing requests for an AWS Bedrock endpoint.
{
"mcpServers": {
"aws-mcp-proxy": {
"command": "uvx",
"args": [
"[email protected]",
"--service", "bedrock",
"--region", "us-east-1",
"--profile", "my-profile",
"https://your-aws-mcp-endpoint.amazonaws.com/mcp"
],
"env": {
"AWS_REGION": "us-east-1"
}
}
}
}Prompts to try
Once connected to an upstream AWS MCP server, the tools exposed depend on that server. Example prompts for common AWS use cases:
- "List all tools available through the AWS endpoint"
- "Query the Bedrock Knowledge Base for documentation about our API"
- "Run the summarization tool on this document"
- "What AWS resources does this MCP server expose?"Troubleshooting AWS MCP Proxy
SignatureDoesNotMatch error when connecting to the AWS endpoint
Verify that --service matches the AWS service that hosts the endpoint (e.g., bedrock, execute-api, lambda) and that --region matches the endpoint's region. Ensure system clock is synchronized — SigV4 is time-sensitive.
ExpiredTokenException or NoCredentialsError
Refresh your AWS credentials. For SSO profiles run: aws sso login --profile my-profile. For IAM users, ensure AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_SESSION_TOKEN are current.
Proxy starts but upstream server returns 403 Forbidden
The IAM principal used must have permission to invoke the target endpoint. Attach the appropriate IAM policy (e.g., bedrock:InvokeModel or execute-api:Invoke) to the user or role.
Frequently Asked Questions about AWS MCP Proxy
What is AWS MCP Proxy?
AWS MCP Proxy is a Model Context Protocol (MCP) server that aws mcp proxy server It connects AI assistants to external tools and data sources through a standardized interface.
How do I install AWS MCP Proxy?
Follow the installation instructions on the AWS MCP Proxy GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with AWS MCP Proxy?
AWS MCP Proxy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is AWS MCP Proxy free to use?
Yes, AWS MCP Proxy is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
AWS MCP Proxy Alternatives — Similar Cloud Services Servers
Looking for alternatives to AWS MCP Proxy? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up AWS MCP Proxy in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use AWS MCP Proxy?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.