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": { ... } } } }

Development

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