AWS FIS

Provides read-only access to AWS FIS data with optional write capabilities for creating and managing fault injection experiments.

python

3

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "radiumgu-aws-fis-mcp-server": {
      "command": "uvx",
      "args": [
        "aws-fis-mcp"
      ],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_PROFILE": "default"
      }
    }
  }
}

You deploy and use the AWS Fault Injection Service (FIS) MCP Server to create, manage, and run chaos experiments against your AWS workloads. This MCP provides a secure, read-only-by-default interface for listing and inspecting experiments, and an explicit opt-in path to enable write operations for creating, starting, stopping, or deleting experiments. It streamlines interactions with AWS FIS by exposing familiar experiment and template operations through a consistent MCP client experience.

How to use

You connect to the MCP server from your MCP client and perform actions using the available commands. Read-only operations let you explore templates, experiments, and action types without risking changes. When you need to run chaos experiments, enable write mode and use the write-enabled commands to create, start, stop, or delete experiment templates and experiments.

How to install

Prerequisites: Python 3.10 or newer and access to AWS with properly configured credentials.

# Option 1: using uvx (recommended)
uvx aws-fis-mcp

# Option 1 alternative (from GitHub)
uvx --from git+https://github.com/RadiumGu/AWS-FIS-MCP.git aws-fis-mcp

# Option 1 local install
cd /home/ec2-user/mcp-servers/AWS-FIS-MCP
uvx --from . aws-fis-mcp

# Option 2: pip install
pip install aws-fis-mcp
# Run
aws-fis-mcp

# Option 3: local development setup (high level steps)
git clone https://github.com/RadiumGu/AWS-FIS-MCP.git
cd AWS-FIS-MCP
# Set up a Python environment and install dependencies as needed
uv python install 3.10
uv venv
source .venv/bin/activate
uv pip install -e .

# Start the MCP server from development setup
aws-fis-mcp
# or
python -m aws_fis_mcp
# or
uv run main.py

Security and runtime behavior

The MCP server operates in read-only mode by default to prevent unintended destructive actions. You enable write operations by starting the server with a dedicated flag that permits writes.

If you attempt a write operation while in read-only mode, you will receive a structured error informing you that write operations are disabled and how to enable them.

Configuration and operation modes

Read-only operations are always available. These include listing templates and experiments, retrieving details, listing action types, and generating template examples.

Write operations require explicit enablement. When enabled, you can start or stop experiments and manage experiment templates.

Recommended usage patterns

Start in read-only mode to explore available templates and experiments.
Identify the template you want to test or modify.
Restart the MCP server with write mode enabled.
Create or update templates, then start an experiment and monitor its progress.

Notes on region handling and AWS credentials

All functions support specifying the AWS region to operate in, with sensible defaults. Ensure your AWS credentials provide the necessary permissions for FIS operations in the target region.

Examples of common actions

List available experiment templates to understand what you can run in your environment.

Generate a template example for a specific target and action type to prototype a new experiment.

Troubleshooting and errors

If a write operation is blocked, confirm you started the MCP server with the appropriate --allow-writes flag. You will see a clear error indicating that write mode is not enabled.

Available tools

list_experiment_templates

List all AWS FIS experiment templates available to you.

get_experiment_template

Retrieve detailed information about a specific experiment template.

create_experiment_template

Create a new AWS FIS experiment template (requires write mode).

delete_experiment_template

Delete an existing AWS FIS experiment template (requires write mode).

list_experiments

List all AWS FIS experiments in your account.

get_experiment

Get detailed information about a specific AWS FIS experiment.

start_experiment

Start a new AWS FIS experiment based on a chosen template (requires write mode).

stop_experiment

Stop a running AWS FIS experiment (requires write mode).

list_action_types

List all available AWS FIS action types.

generate_template_example

Generate an example template for a given target and action type.