mcp-server-terraform

An MCP (Model Context Protocol) server that exposes Terraform CLI operations as tools for Claude and other MCP-compatible AI assistants. Enables AI-driven infrastructure-as-code workflows including planning, applying, and validating Terraform configurations.

Architecture

graph TB
    subgraph Client["MCP Client (Claude)"]
        style Client fill:#4A90D9,stroke:#2C5F8A,color:#FFFFFF
        A[Claude Desktop / CLI]
    end

    subgraph Server["MCP Server"]
        style Server fill:#2ECC71,stroke:#1A9B52,color:#FFFFFF
        B[StdioTransport]
        C[Tool Registry]
    end

    subgraph Tools["Terraform Tools"]
        style Tools fill:#F39C12,stroke:#D68910,color:#FFFFFF
        D[terraform_init]
        E[terraform_plan]
        F[terraform_apply]
        G[terraform_validate]
        H[terraform_state_list]
        I[terraform_output]
    end

    subgraph Infra["Infrastructure"]
        style Infra fill:#9B59B6,stroke:#7D3C98,color:#FFFFFF
        J[Terraform CLI]
        K[State Backend]
        L[Cloud Providers]
    end

    A -->|stdio| B
    B --> C
    C --> D
    C --> E
    C --> F
    C --> G
    C --> H
    C --> I
    D --> J
    E --> J
    F --> J
    G --> J
    H --> J
    I --> J
    J --> K
    J --> L

Tools

Quick Start

npm install
npm run build
npm start

Docker

docker build -t mcp-server-terraform .
docker run -i mcp-server-terraform

Claude Desktop Configuration

{
  "mcpServers": {
    "terraform": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/mcp-server-terraform"
    }
  }
}

License

MIT