@ldavis9000aws/aws-mcp-jv3 NPM

AWS MCP - AWS SDK for Java 3

A simplified Model Context Protocol (MCP) server for AWS SDK for Java 3, designed with simplicity in mind.

Features

Direct AWS SDK for Java 3 integration using pre-defined service clients
No dynamic module loading or runtime npm installations
Simple profile and credential management
Executes AWS code in a VM sandbox
Follows the original MCP server design pattern

Installation

Option 1: Install via npx (Recommended)

The easiest way to use this tool is via npx, which doesn't require installing the package:

npx aws-mcp-jv3

Option 2: Install globally

npm install -g aws-mcp-jv3
aws-mcp-jv3

Option 3: Clone and build from source

git clone https://github.com/ldavis9000aws/aws-mcp-jv3-v2.git
cd aws-mcp-jv3-v2
npm install
npm run build
npm start

Claude Desktop Configuration

To use this tool with Claude Desktop, follow these steps:

Windows

Open Claude Desktop application
Click on the gear icon in the bottom left corner to open Settings
Navigate to the "MCP Tools" section
Click "Add New Tool"

Configure the tool:

Name: AWS SDK v3
Description: Execute AWS SDK for Java 3 code
Command: npx aws-mcp-jv3

Click "Save"
Restart Claude Desktop

macOS/Linux

Open Claude Desktop application
Click on the gear icon in the bottom left corner to open Settings
Navigate to the "MCP Tools" section
Click "Add New Tool"

Configure the tool:

Name: AWS SDK v3
Description: Execute AWS SDK for Java 3 code
Command: npx aws-mcp-jv3

Click "Save"
Restart Claude Desktop

LibreChat Configuration

To use this tool with LibreChat, you need to add it to your librechat.yaml configuration:

Method 1: Using MCP Servers section

# librechat.yaml
mcp:
  servers:
    aws-sdk-v3:
      command: npx aws-mcp-jv3
      description: Execute AWS SDK for Java 3 code

Method 2: Using Tools section (alternative)

# librechat.yaml
tools:
  mcp:
    servers:
      aws-sdk-v3:
        command: npx aws-mcp-jv3
        description: Execute AWS SDK for Java 3 code

After updating your config, restart LibreChat to apply the changes.

Permissions for MCP Tools

For both Claude Desktop and LibreChat:

Make sure you have Node.js (v16 or higher) installed on your system
If running with restricted permissions, you may need to:
- On Windows: Run Claude Desktop or LibreChat as Administrator the first time
- On Linux/macOS: Run sudo npm install -g aws-mcp-jv3 first

Usage with Claude

When using Claude with this tool:

First, list available AWS profiles:

Please list my AWS profiles using the AWS SDK v3 tool.

Select a profile before executing code:

Please select the "default" AWS profile using the AWS SDK v3 tool.

Run AWS SDK v3 code:

Using AWS SDK v3, please list all my S3 buckets.

Available Tools

run-aws-code - Execute AWS SDK for Java 3 code
list-credentials - List available AWS profiles
select-profile - Select an AWS profile to use for subsequent operations

Example Commands

Example 1: List S3 buckets

Using AWS SDK v3, list all my S3 buckets.

Claude will execute:

await run-aws-code({
  reasoning: "List all S3 buckets in the account",
  code: `
    const { ListBucketsCommand } = require("@aws-sdk/client-s3");
    const s3Client = await getClient("s3");
    const response = await s3Client.send(new ListBucketsCommand({}));
    return response.Buckets;
  `
});

Example 2: List EC2 instances

Using AWS SDK v3, show me all my EC2 instances.

Claude will execute:

await run-aws-code({
  reasoning: "Retrieve EC2 instances information",
  code: `
    const { DescribeInstancesCommand } = require("@aws-sdk/client-ec2");
    const ec2Client = await getClient("ec2");
    const response = await ec2Client.send(new DescribeInstancesCommand({}));
    
    // Extract relevant instance information
    const instances = [];
    for (const reservation of response.Reservations || []) {
      for (const instance of reservation.Instances || []) {
        instances.push({
          id: instance.InstanceId,
          type: instance.InstanceType,
          state: instance.State?.Name,
          publicIp: instance.PublicIpAddress,
          privateIp: instance.PrivateIpAddress,
          launchTime: instance.LaunchTime
        });
      }
    }
    return instances;
  `
});

Troubleshooting

Common Issues

Error: Cannot find module
- Ensure Node.js (v16+) is installed
- Try running npm cache clean --force and then retry
Error loading AWS profiles
- Check that your AWS credentials file exists at:
  - Windows: %USERPROFILE%\.aws\credentials
  - Linux/macOS: ~/.aws/credentials
Permission denied errors
- Run with elevated permissions the first time
- Check file permissions on your .aws directory
Timeout when executing AWS commands
- Verify your internet connection
- Check AWS region settings
- Confirm your AWS credentials are valid