What is Sar Mcp

sar-mcp is an MCP Server designed to provide access to the AWS Programmatic Service Authorization Reference, enabling users to interact with AWS services and their associated API actions.

Use cases

Use cases for sar-mcp include developers needing to understand AWS service capabilities, security professionals verifying API conditions and resource types, and teams automating AWS service interactions through programmatic access.

How to use

To use sar-mcp, first ensure you have Python 3.10 or higher installed. Clone the repository, set up a virtual environment, and install the required dependencies. You can run the server directly or configure it with Claude Desktop for easier access.

Key features

Key features of sar-mcp include the ability to list all available AWS services, retrieve API actions for specific services, obtain condition keys for API actions, and identify resource types supported by those actions.

Where to use

undefined

AWS Service Reference MCP Server

This MCP server provides tools to interact with the AWS Programmatic Service Reference, allowing you to:

• List all available AWS services
• Get API actions for specific AWS services
• Get condition keys supported by specific API actions
• Get resource types supported by specific API actions

Installation

1. Make sure you have Python 3.10 or higher installed
2. Clone this repository
3. Install the required dependencies:

# Create and activate a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows

# Install dependencies
pip install -r requirements.txt

Usage

Running the Server

You can run the server directly:

python aws_service_reference.py

Using with Claude Desktop

1. Open your Claude Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration:

{
  "mcpServers": {
    "aws-service-reference": {
      "command": "python",
      "args": [
        "/ABSOLUTE/PATH/TO/aws_service_reference.py"
      ]
    }
  }
}

Replace /ABSOLUTE/PATH/TO/ with the actual path to where you saved the server file.

3. Restart Claude Desktop

Available Tools

The server provides four tools:

1. list_aws_services: Lists all available AWS services
2. get_service_actions: Gets API actions for a specific AWS service
3. get_action_condition_keys: Gets condition keys supported by a specific API action
4. get_action_resource_types: Gets resource types supported by a specific API action

Example Usage in Claude

Once connected, you can ask Claude questions like:

• “What AWS services are available?”
• “Show me all the API actions for the S3 service”
• “What condition keys are supported by the s3:PutObject action?”
• “What resource types can I use with the ec2:RunInstances action?”

Development

Testing with MCP Inspector

You can test the server using the MCP Inspector:

mcp dev aws_service_reference.py

Dependencies

The project uses the following dependencies (specified in requirements.txt):

• mcp[cli]>=0.1.0: The Model Context Protocol SDK with CLI tools
• httpx>=0.26.0: Modern HTTP client for making API requests

Troubleshooting

If you encounter issues:

1. Verify your Python version is 3.10 or higher
2. Ensure all dependencies are installed correctly:

   pip install -r requirements.txt
   

3. Check the Claude Desktop logs:
   • macOS: ~/Library/Logs/Claude/mcp*.log
   • Windows: %APPDATA%\Claude\logs\mcp*.log
4. Make sure you’re using absolute paths in the Claude Desktop configuration

License

This project is licensed under the MIT License.