Terraform Mcp Server By Binadox

Binadox 提供的 Terraform MCP 服务

用于 Terraform 的 MCP 服务 — 自动验证和保护 Terraform 配置，并估算云成本。由 Binadox 开发，可与任何 Model Context Protocol (MCP) 客户端集成（例如 Claude Desktop 或其他兼容 MCP 的 AI 助手）。

---

目录

• 概述
• 功能
• 兼容性与要求
• 安装
• 用法
• 示例
• 安全与隐私
• API 要求
• 文档
• 许可证

---

概述

Binadox Terraform MCP 服务 是一个 MCP（Model Context Protocol）服务，可帮助大语言模型（LLM）安全地生成 Terraform 基础设施代码，并在部署前进行内置成本估算和安全检查。

它充当 AI 助手与 Terraform 之间的桥梁：当大模型需要生成或修改云基础设施代码时，此服务会通过结构化工具（验证、Lint、安全分析、成本数据）增强 AI 的响应，而不是完全依赖模型猜测。这样，从一开始生成的 Terraform 配置就会更加完整、安全，并考虑成本。

在此了解如何使用我们的工具管理由 Terraform 驱动的基础设施：Binadox IaC Cost Tracker。

---

功能

• 代码验证与补全 — 处理 Terraform 代码片段，并补全缺失部分（提供程序、版本、变量），以生成可运行的配置。
• 安全分析 — 检测生成代码中常见的错误配置和不安全的默认设置（开放端口、缺少加密等）。
• 成本估算 — 使用实际定价数据，计算所提议资源的每月云成本明细。
• 文件组织 — 将输出整理为逻辑清晰的 Terraform 文件/模块（例如，将资源归入模块，并在需要时添加 terraform.tfvars）。
• 轻松集成 — 可与任何兼容 MCP 的客户端配合使用（已在 Claude Desktop 中测试），无缝融入 AI 驱动的工作流。

---

兼容性与要求

组件	支持 / 已测试版本
Go	1.22+
Terraform CLI	1.6+
云平台	AWS（完整支持：成本 + 检查）、Azure 和 GCP（仅成本，检查已列入路线图）
MCP 客户端	Claude Desktop（已测试），其他兼容 MCP 的客户端

先决条件

• Go 工具链（如果从源代码构建）
• 已安装 Terraform CLI 1.6+
• 有效的 Binadox API 令牌
• 可访问 Binadox 定价 API 的互联网连接
• 对 /tmp/terraform/... 的写入权限

---

安装

要安装 binadox-terraform-mcp，请克隆代码仓库并使用 Go 构建二进制文件。然后，将可执行文件路径添加到 Claude Desktop 配置文件 claude_desktop_config.json 的 mcpServers 部分，并填写 Binadox API URL 和令牌。最后，重启 Claude Desktop 以应用更改并开始使用 Terraform MCP 服务。

1. 克隆并构建：

git clone https://github.com/binadox/binadox-terraform-mcp
cd binadox-terraform-mcp
go build -o terraform-mcp-server *.go

2. 配置 MCP 客户端（示例：Claude Desktop）

# Add to Claude Desktop config
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "terraform": {
      "command": "/path/to/terraform-mcp-server",
      "env": {
        "TERRAFORM_ANALYSIS_URL": "https://app.binadox.com/api/1/organizations/pricing/terraform/mcp",
        "TERRAFORM_ANALYSIS_TOKEN": "your-token"
      }
    }
  }
}

3. 重启 MCP 客户端以应用配置。

用法

无需额外的 CLI 命令。安装并配置后，服务会在后台运行，以执行以下操作：

• 通过 prepare_terraform 验证并补全 Terraform 代码
• 通过 analyze_terraform 分析配置错误
• 通过 calculate_cost 估算云成本

所有输出文件都会写入 /tmp/terraform/<timestamp>，并在需要时打包为 ZIP 文件。

---

示例

防止成本超支

User: Generate terraform for a simple demo environment

Cost Analysis: $1,847/month
- m5.2xlarge instances
- Multi-AZ RDS
- NAT Gateways in 3 AZs

检测安全配置错误

User: Create an RDS database with a security group

Security Analysis:
- 0.0.0.0/0 open access
- No encryption at rest
- 1-day backup retention

补全不完整的配置

User: Add resource "aws_s3_bucket" "data" { bucket = "my-data" }

Without MCP: Fails – no provider block  
With MCP: Adds provider, variables, and metadata – configuration runs

---

安全与隐私

服务在本地运行，不会访问云凭据。

• 文件保存在 /tmp/terraform/ 下，不会发送到外部。
• 仅使用你的 Binadox 令牌远程请求成本数据。
• 不会收集遥测数据或分析数据。

---

API 要求

成本分析需要 Binadox API 令牌。Binadox 提供 AWS、Azure 和 GCP 的实时云定价数据。请在 Binadox 获取令牌。

---

文档

• 架构 - 技术深度解析
• 示例 - 常见提示词和模式
• 测试 - 测试场景
• 部署 - 生产环境设置

---

许可证

Apache 2.0