MCP Terraform Assistant

🚀 MCP Infrastructure as Code Assistant

An MCP server for managing infrastructure as code using Terraform.

🚀 Quick Start

The MCP Infrastructure as Code Assistant is a powerful tool that leverages Terraform to manage infrastructure as code. It provides a range of functions to streamline the infrastructure management process.

✨ Features

• Initialize the Terraform working directory.
• Generate and display the execution plan.
• Apply infrastructure changes.
• Destroy the infrastructure.
• Validate the Terraform configuration.
• Display the current state or saved plan.
• Manage Terraform workspaces.

📦 Installation

Local Installation

1. Clone the repository:

git clone https://github.com/yourusername/mcp-iac.git
cd mcp-iac

2. Install dependencies using uv:

curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install -e .

Docker Installation

1. Clone the repository:

git clone https://github.com/yourusername/mcp-iac.git
cd mcp-iac

2. Build and run the Docker container:

docker-compose up -d

💻 Usage Examples

Local Usage

1. Start the MCP server:

python main.py

2. Interact with the server using the MCP CLI:

mcp terraform_init --working-dir ./terraform
mcp terraform_plan --working-dir ./terraform
mcp terraform_apply --working-dir ./terraform --auto-approve

Docker Usage

1. Start the MCP server:

docker-compose up -d

2. Interact with the server using the MCP CLI:

mcp terraform_init --working-dir ./terraform
mcp terraform_plan --working-dir ./terraform
mcp terraform_apply --working-dir ./terraform --auto-approve

Basic Usage

# Example Terraform configuration for creating an EC2 instance on AWS
terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

provider "aws" {
  region = var.region
}

resource "aws_instance" "example" {
  ami           = var.ami_id
  instance_type = var.instance_type

  tags = {
    Name = var.instance_name
  }
}

📚 Documentation

Prerequisites

• Python 3.8 or higher.
• Terraform 1.5.7 or higher.
• Docker and Docker Compose (optional).

Available Tools

• terraform_init: Initialize the Terraform working directory.
• terraform_plan: Generate and display the Terraform execution plan.
• terraform_apply: Apply the changes required to reach the desired state.
• terraform_destroy: Destroy the infrastructure managed by Terraform.
• terraform_validate: Validate the Terraform configuration.

🔧 Technical Details

The MCP Infrastructure as Code Assistant uses Terraform to manage infrastructure as code. It provides a set of commands to interact with Terraform, allowing users to manage infrastructure in a more efficient and automated way.

🤝 Contribution

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a pull request.

📄 License

This project is released under the MIT License. See the LICENSE file for details.