home / mcp / aws mcp server

AWS MCP Server

Talk with your AWS using Claude. Model Context Protocol (MCP) server for AWS. Better Amazon Q alternative.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "rafalwilinski-aws-mcp": {
      "command": "npm",
      "args": [
        "--silent",
        "--prefix",
        "/Users/<YOUR USERNAME>/aws-mcp",
        "start"
      ]
    }
  }
}

You run a Model Context Protocol (MCP) server that lets AI assistants like Claude interact with your AWS environment. It enables natural language querying and management of AWS resources during conversations while keeping your local credentials secure.

How to use

Launch the AWS MCP server from your local environment and configure Claude Desktop to connect to it. You can then ask questions or issue actions about your AWS resources through natural language.

Start by selecting an AWS profile or saying a natural-language action to begin. Examples include asking to list available AWS profiles, list EC2 instances, show S3 buckets with sizes, query Lambda functions in a region, or list ECS clusters and their services.

How to install

Prerequisites you need locally are Node.js, Claude Desktop, and AWS credentials configured in your AWS credentials file (typically in ~/.aws/). Make sure Claude Desktop is installed and you have permission to run local MCP servers.

Step 1: Clone the AWS MCP project directory and install dependencies.

git clone https://github.com/RafalWilinski/aws-mcp
cd aws-mcp
pnpm install
# or
npm install

Configure Claude to connect to AWS MCP

Open Claude Desktop and navigate to Settings -> Developer -> Edit Config. Add a new MCP server entry to connect to the local AWS MCP server.

{
  "mcpServers": {
    "aws": {
      "command": "npm", // OR pnpm
      "args": [
        "--silent",
        "--prefix",
        "/Users/<YOUR USERNAME>/aws-mcp",
        "start"
      ]
    }
  }
}

Start the AWS MCP server using the CLI configuration (nvm alternative)

If you are using nvm to manage Node versions, you can start the server with the Node executable and the TypeScript entry point.

{
  "mcpServers": {
    "aws": {
      "command": "/Users/<USERNAME>/.nvm/versions/node/v20.10.0/bin/node",
      "args": [
        "<WORKSPACE_PATH>/aws-mcp/node_modules/tsx/dist/cli.mjs",
        "<WORKSPACE_PATH>/aws-mcp/index.ts",
        "--prefix",
        "<WORKSPACE_PATH>/aws-mcp",
        "start"
      ]
    }
  }
}

Troubleshooting and tips

If you encounter issues, check the logs for the MCP server and Claude’s logs. Look for entries indicating startup success or credential-related errors.