AWS Cloud Interface Bridge (CIB)

This implementation functions as a Model Context Protocol (MCP) endpoint, as defined by Anthropic, designed specifically for interaction with the Amazon Web Services ecosystem. It translates plain-language instructions from AI models into actionable AWS API calls, effectively serving as a sophisticated, conversational management layer for your cloud resources. Consider this a robust alternative to existing managed cloud AI tools.

Core Capabilities

• 🗣️ Interpret natural language commands to inspect or alter AWS resources.
• 🆔 Comprehensive management for numerous AWS user profiles and integration with SSO.
• 🌎 Support spanning all major global AWS regions.
• 🔒 Rigorous security: Utilizes your existing local credential store; no sensitive keys are transmitted externally.
• 💻 Execution environment is confined to your local machine using your configured AWS access.

Requirements Checklist

• A functional installation of Node.js.
• The Claude Desktop Application.
• Properly configured local AWS credentials, typically located in ~/.aws/.

Setup Procedure

1. Obtain the source code:

bash git clone https://github.com/RafalWilinski/aws-mcp cd aws-mcp

1. Install project dependencies:

bash pnpm install

Alternatively:

npm install

Operationalizing the Bridge

1. Access the Claude desktop client settings: Navigate to Settings -> Developer -> Configuration Editor.

2. Inject the following configuration block into your claude_desktop_config.json file:

{ "mcpServers": { "aws": { "command": "npm", // Or "pnpm" "args": [ "--silent", "--prefix", "/Users//aws-mcp", "start" ] } } }

Crucial Step: Substitute /Users/<YOUR USERNAME>/aws-mcp with the absolute path where you cloned the repository.

1. Relaunch the Claude application to activate the new endpoint.

2. Initiate interaction by first listing profiles or directly issuing requests such as:

3. "Display all configured AWS profiles."
4. "Fetch the status of every running EC2 instance."
5. "Report on S3 storage volumes and capacities."
6. "Query for deployed Lambda functions within the us-east-1 region."
7. "Enumerate all ECS clusters and their associated services."

Node Version Manager (nvm) Specific Configuration

If compiling from source while using nvm, use this configuration structure instead:

{ "mcpServers": { "aws": { "command": "/Users//.nvm/versions/node/v20.10.0/bin/node", "args": [ "/aws-mcp/node_modules/tsx/dist/cli.mjs", "/aws-mcp/index.ts", "--prefix", "/aws-mcp", "start" ] } } }

Debugging Connection Issues

Examine the server logs using the following tail commands:

bash tail -n 50 -f ~/Library/Logs/Claude/mcp-server-aws.log

Alternatively, check the generic MCP log:

tail -n 50 -f ~/Library/Logs/Claude/mcp.log

Roadmap (In Progress)

• [ ] Integration for Multi-Factor Authentication (MFA) flows.
• [ ] Implementing a local cache for SSO tokens to optimize credential refresh cycles.

WIKIPEDIA: XMLHttpRequest (XHR) defines a JavaScript API for making HTTP requests from a web page to a server asynchronously. This capability is foundational to modern web interactivity (Ajax), allowing content updates without requiring a full page reload, a significant departure from earlier reliance on form submissions and hyperlinks for server communication.