Terraform Manager MCP Server

Cloud PlatformsRust

Manage and operate Terraform environments through AI assistants

Available Tools

read_terraform_config

Reads and parses Terraform configuration files from a specified directory

analyze_terraform_plan

Analyzes the output of a Terraform plan and provides a summary of changes

apply_terraform_config

Applies Terraform configurations to create or modify infrastructure

manage_terraform_state

Manages Terraform state files and operations

Terraform Manager is an experimental CLI tool that enables AI assistants to interact with Terraform environments. It provides a bridge between large language models and infrastructure as code, allowing for reading configurations, analyzing plans, applying changes, and managing state through the Model Context Protocol (MCP). This tool streamlines infrastructure management by leveraging AI capabilities to understand and manipulate Terraform resources.

Overview

Terraform Manager (tfmcp) is a command-line tool that enables AI assistants to manage and operate your Terraform environments through the Model Context Protocol (MCP). This experimental tool bridges the gap between AI and infrastructure as code, allowing for more intuitive management of cloud resources.

Installation

You can install Terraform Manager using one of the following methods:

Using Cargo (Recommended)

If you have Rust installed, you can install directly from Crates.io:

cargo install tfmcp

From Source

To build and install from source:

# Clone the repository
git clone https://github.com/nwiizo/tfmcp
cd tfmcp

# Build and install
cargo install --path .

Using Docker

For a containerized deployment:

# Clone the repository
git clone https://github.com/nwiizo/tfmcp
cd tfmcp

# Build the Docker image
docker build -t tfmcp .

# Run the container
docker run -it tfmcp

Requirements

Before using Terraform Manager, ensure you have:

Terraform CLI installed and available in your PATH
Rust (edition 2021) if installing from source
Claude Desktop or another compatible AI assistant for integration
Docker (optional, for containerized deployment)

Usage

Terraform Manager can be used in several ways:

As an MCP Server

To launch as an MCP server for AI assistant integration:

tfmcp mcp

Analyzing Terraform Configurations

To analyze existing Terraform configurations:

tfmcp analyze --path /path/to/terraform/project

Getting Help

For a complete list of commands and options:

tfmcp --help

Integration with Claude Desktop

Terraform Manager works seamlessly with Claude Desktop. Once the MCP server is running, Claude can:

Read and understand your Terraform configuration files
Analyze plan outputs to explain proposed changes
Apply configurations and manage state
Help create or modify Terraform configurations based on your requirements

Example Workflow

Start the MCP server: tfmcp mcp
Connect your AI assistant to the MCP server
Ask your assistant to analyze your Terraform configurations
Request explanations of planned changes
Have the assistant apply changes when ready

Best Practices

Always review changes suggested by the AI before applying them
Use version control for your Terraform configurations
Start with non-production environments when testing this tool
Keep Terraform and the tool updated to the latest versions

Troubleshooting

If you encounter issues:

Ensure Terraform is properly installed and accessible
Check that your Terraform configurations are valid
Verify the MCP server is running correctly
Consult the logs for detailed error information

Remember that Terraform Manager is experimental, so features may change without notice. Use with caution in production environments.