# 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**:
```bash
npm install
```
2. **Build the project**:
```bash
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:
```bash
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.
```json
{
"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**:
```bash
npm pack
```
This creates a file like `mcp-server-aws-1.0.0.tgz`.
2. **Team members** install it globally (or locally):
```bash
npm install -g mcp-server-aws-1.0.0.tgz
```
3. **Configure MCP Client**:
If installed globally, they can run it directly:
```json
{
"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):
```bash
npx tsx watch src/index.ts
```
