guilhermeyoshida/mcp-terraform-assistant

An MCP server for managing infrastructure as code with Terraform.
Features
- Initialize Terraform working directories
- Generate and show execution plans
- Apply changes to infrastructure
- Destroy infrastructure
- Validate Terraform configurations
- Show current state or saved plans
- Manage Terraform workspaces
Prerequisites
- Python 3.8 or higher
- Terraform 1.5.7 or higher
- Docker and Docker Compose (optional)
Installation
Local Installation
1. Clone the repository:
2. Install dependencies using uv:
Docker Installation
1. Clone the repository:
2. Build and run the Docker container:
Usage
Local Usage
1. Start the MCP server:
2. Use the MCP CLI to interact with the server:
Docker Usage
1. Start the MCP server:
2. Use the MCP CLI to interact with the server:
Example Terraform Configuration
The repository includes an example Terraform configuration that creates an EC2 instance in AWS:
Contributing
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 licensed under the MIT License - see the LICENSE file for details.
Available Tools
- terraform_init: Initialize a Terraform working directory
- terraform_plan: Generate and show an execution plan for Terraform
- terraform_apply: Apply the changes required to reach the desired state
- terraform_destroy: Destroy the infrastructure managed by Terraform
- terraform_validate: Validate the syntax and internal consistency of Terraform files
- terraform_show: Show the current state or a saved plan
- terraform_workspace_list: List Terraform workspaces
- terraform_workspace_select: Select a Terraform workspace
Example Usage
Here's an example of how to use the MCP server with an AI agent:
1. Start the MCP server:
2. Connect to the server using an MCP client:
3. The AI agent can now help you with Terraform operations. For example:
- Initialize a Terraform working directory
- Generate and review execution plans
- Apply changes to infrastructure
- Destroy infrastructure resources