hc-mcp-aws 2025.4.10

HC MCP server for AWS monitoring and management

HC MCP AWS Server

A Model Context Protocol (MCP) server for AWS monitoring and management.

Overview

HC MCP AWS Server provides a set of tools and resources for monitoring and managing AWS resources through the Model Context Protocol (MCP). It allows AI assistants to interact with AWS services, fetch CloudWatch logs, analyze security findings, and discover resources across your AWS accounts.

Features

• Organization Management: View AWS organization structure and resolve account identifiers
• CloudWatch Monitoring: Access dashboards, logs, and alarms
• Security Analysis: Retrieve and analyze Security Hub findings and Inspector vulnerabilities
• WAF Management: Monitor and analyze WAF configurations and metrics
• Resource Discovery: Discover resources across various AWS services

Installation

pip install hc-mcp-aws

Usage

Running the Server

hc-mcp-aws

Command-line Options

• --version: Show version information and exit
• --debug: Enable debug logging

AWS Authentication

The server uses boto3 for AWS authentication and supports the following methods:

1. Default Credentials: For accessing resources in the default AWS account
2. Profile-based Authentication: For cross-account access using named profiles in the format AdministratorAccess@Account_Name

Development

Prerequisites

• Python 3.10 or higher
• AWS credentials configured

Setup Development Environment

# Clone the repository
git clone https://github.com/yourusername/hc-mcp-aws.git
cd hc-mcp-aws

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e .

Running Tests

pytest

License

MIT License

Acknowledgements

This project is built on the Model Context Protocol (MCP) framework and uses boto3 for AWS interactions.