AWS MCP Server

This is a Model Context Protocol (MCP) server that provides read-only access to AWS resources. It is built using TypeScript and the AWS SDK v3.

Features

This server exposes the following tools:

• get_aws_caller_identity: Verify the current AWS credentials.
• list_s3_buckets: List all S3 buckets.
• list_ec2_instances: List EC2 instances in the configured region (or a specified region).
• list_iam_users: List IAM users.

Prerequisites

• Node.js (v16 or higher)
• AWS Credentials (Access Key ID and Secret Access Key) with read-only permissions.

Setup

1. Install dependencies:

   npm install
   

2. Build the project:

   npm run build
   

   (Note: npm run build is not defined in package.json yet, command is npx tsc)

Usage (Private / Team)

Since this is a private tool, you can share it with your team in two main ways:

Option 1: Share via Git (Recommended)

1. Push this code to your private repository (GitHub, GitLab, etc.).

2. Team members should clone the repository:

   git clone <your-private-repo-url>
   cd mcp-server-aws
   npm install
   npm run build
   

3. Configure MCP Client: Use the absolute path to the locally built file.

   {
     "mcpServers": {
       "aws-mcp": {
         "command": "node",
         "args": ["/path/to/cloned/repo/dist/index.js"],
         "env": {
           "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY",
           "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_KEY",
           "AWS_REGION": "us-east-1"
         }
       }
     }
   }
   

Option 2: Share as a Single File (.tgz)

You can package the server into a single file and send it to your team (Slack, Email, Sharepoint).

1. Create the package:

   npm pack
   

   This creates a file like mcp-server-aws-1.0.0.tgz.

2. Team members install it globally (or locally):

   npm install -g mcp-server-aws-1.0.0.tgz
   

3. Configure MCP Client: If installed globally, they can run it directly:

   {
     "mcpServers": {
       "aws-mcp": {
         "command": "mcp-server-aws",
         "args": [],
         "env": { ... }
       }
     }
   }
   
   

### Option 2: Running Locally

If you cloned the repository and built it locally:

**Command**: `node`
**Args**: `/path/to/dist/index.js` (Absolute path recommended)

**Example Configuration (JSON)**:

```json
{
  "mcpServers": {
    "aws-mcp": {
      "command": "node",
      "args": ["/Users/bhaveshkumarparmar/Desktop/Shellkode/MSP-Projects/MCP-server-aws/dist/index.js"],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY",
        "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_KEY",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

Development

To run the server in development mode (watching for changes):

npx tsx watch src/index.ts