# aws-mcp-server

> MCP Server

This repository provides an MCP server that uses the AWS SDK to retrieve and list running EC2 instances for a specified AWS region. It requires Node.js, an AWS account, and

## Overview

- **Category:** System Tools
- **Language:** JavaScript
- **Stars:** 2
- **Forks:** 0
- **Owner:** codewithdpk
- **GitHub:** https://github.com/codewithdpk/aws-mcp-server
- **Created:** 2025-03-28T12:41:10+00:00
- **Updated:** 2025-03-28T13:36:47+00:00
- **Source:** https://model-context-protocol.com/servers/aws-mcp-server-model-context-protocol

## Setup

## Setup

1.  Clone the Repository:

    ```bash
git clone https://github.com/codewithdpk/aws-mcp-server.git
cd aws-mcp-server
    ```

2.  Install Dependencies:

    ```bash
npm install
    ```

3.  Configure AWS Credentials: Create a `.env` file in the project root with your AWS credentials:

    ```
AWS_ACCESS_KEY_ID=your_access_key_id
AWS_ACCESS_SECRET_KEY=your_secret_access_key
    ```

4. Build the server:

    ```bash
npm run build
    ```

5. Testing your server with Claude for Desktop: Configure Claude for Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` and add your servers in the `mcpServers` key.

    ```json
{
    "mcpServers": {
        "aws-mcp-server": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/aws-mcp-server/build/index.js"
            ]
        }
    }
}
    ```

## Tools

## Available Tools

1. Retrieve running EC2 instances (for a specified AWS region).
2. Support for multiple availability zones.
3. Detailed instance information (including Instance ID, Instance Type, Public IP, Private IP, Instance State).
4. `get-aws-instances` (Retrieves list of running AWS instances for a given region).