https://github.com/mitchybawesome/sar-mcp
An MCP Server for accessing the AWS Programatic Service Authorisation Reference
https://github.com/mitchybawesome/sar-mcp
List: sar-mcp
Last synced: 3 months ago
JSON representation
An MCP Server for accessing the AWS Programatic Service Authorisation Reference
- Host: GitHub
- URL: https://github.com/mitchybawesome/sar-mcp
- Owner: MitchyBAwesome
- Created: 2025-03-12T09:06:08.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-13T19:45:33.000Z (7 months ago)
- Last Synced: 2025-03-13T20:36:12.504Z (7 months ago)
- Language: Python
- Size: 1.95 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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:
```bash
# 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:
```bash
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:
```json
{
"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:
```bash
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:
```bash
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.