LitmusChaos MCP Server

A comprehensive Model Context Protocol (MCP) server for LitmusChaos 3.x, built in Go, enabling AI assistants like Claude to interact with your chaos engineering platform. This server provides a complete interface for managing chaos experiments, infrastructures, environments, and resilience probes through natural language interactions.

Features

🧪 Chaos Experiment Management

• List and describe chaos experiments
• Execute experiments on-demand or via schedules
• Stop running experiments with granular control

🏗️ Infrastructure Operations

• List and Get chaos infrastructure Details (formerly agents/chaos delegates)
• Monitor infrastructure health and status
• Generate installation manifests
• Support for both namespace and cluster-scoped deployments

🌍 Environment Organization

• Create and manage environments (PROD/NON_PROD)
• Organize infrastructures by environment
• Environment-based filtering and operations

📊 Experiment Execution Tracking

• Detailed experiment run history and status
• Real-time execution monitoring
• Fault-level success/failure tracking
• Resiliency score calculations

🔍 Resilience Probes

• HTTP, Command, Kubernetes, and Prometheus probes
• Plug-and-play probe architecture
• Steady-state validation during chaos

📚 ChaosHub Integration

• Browse available chaos faults
• Multiple hub support (Git and Remote)
• Fault categorization and discovery

📈 Statistics & Analytics

• Comprehensive experiment and infrastructure statistics
• Resiliency score distributions
• Run status breakdowns

Prerequisites

• Go 1.21 or higher
• Access to a LitmusChaos 3.x Chaos Center
• Valid project credentials

Installation

From Source

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

# Build the binary
make build

# Or install directly
make install

Using Go Install

go install github.com/yourusername/litmuschaos-mcp-server@latest

Using Docker

# Build the Docker image
make docker-build

# Run with Docker
docker run --rm -it \
  -e CHAOS_CENTER_ENDPOINT=http://your-chaos-center:8080 \
  -e LITMUS_PROJECT_ID=your-project-id \
  -e LITMUS_ACCESS_TOKEN=your-token \
  litmuschaos-mcp-server:latest

Configuration

Environment Variables

# Required Configuration
export CHAOS_CENTER_ENDPOINT=http://your-chaos-center:8080
export LITMUS_PROJECT_ID=your-project-id
export LITMUS_ACCESS_TOKEN=your-access-token

# Optional Defaults
export DEFAULT_INFRA_ID=your-default-infrastructure-id
export DEFAULT_ENVIRONMENT_ID=production

Getting Your Credentials

1. Chaos Center Endpoint: URL of your LitmusChaos installation
2. Project ID: Found in your Chaos Center project settings
3. Access Token: Generate from Chaos Center → Settings → Access Tokens

Usage

With Claude Desktop

Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "litmuschaos": {
      "command": "/path/to/litmuschaos-mcp-server",
      "env": {
        "CHAOS_CENTER_ENDPOINT": "http://localhost:8080",
        "LITMUS_PROJECT_ID": "your-project-id",
        "LITMUS_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

Standalone Usage

# Using environment variables
./bin/litmuschaos-mcp-server

# Or with make
make run

Development

Setup Development Environment

# Clone and setup
git clone https://github.com/yourusername/litmuschaos-mcp-server.git
cd litmuschaos-mcp-server

# Install dependencies
make deps

# Run with hot reload (requires air)
make dev

Development Commands

# Build the project
make build

# Run tests
make test

# Run tests with coverage
make test-coverage

# Format code
make fmt

# Run linter
make lint

# Run all checks
make check

# Clean build artifacts
make clean

# Build for all platforms
make build-all

Project Structure

.
├─

... [View full README on GitHub](https://github.com/litmuschaos/litmus-mcp-server#readme)