MCP Terraform Assistant

🚀 MCP 基礎設施作為代碼助理

MCP 基礎設施作為代碼助理是一個藉助 Terraform 來管理基礎設施代碼的 MCP 服務器，能高效處理基礎設施的各項操作，提升管理效率。

🚀 快速開始

本項目可通過本地或 Docker 兩種方式進行安裝和使用。

✨ 主要特性

• 初始化 Terraform 工作目錄，為後續操作做好準備。
• 生成和顯示執行計劃，讓用戶清晰瞭解基礎設施的變更情況。
• 應用基礎設施更改，確保基礎設施達到所需狀態。
• 摧毀基礎設施，方便資源回收和環境清理。
• 驗證 Terraform 配置，保證配置的正確性。
• 顯示當前狀態或保存的計劃，便於用戶掌握即時信息。
• 管理 Terraform 工作區，實現多環境的靈活管理。

📦 安裝指南

本地安裝

1. 克隆倉庫：

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

2. 使用 uv 安裝依賴項：

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

Docker 安裝

1. 克隆倉庫：

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

2. 構建並運行 Docker 容器：

   docker-compose up -d
   

💻 使用示例

本地使用

1. 啟動 MCP 服務器：

   python main.py
   

2. 使用 MCP CLI 與服務器交互：

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

Docker 使用

1. 啟動 MCP 服務器：

   docker-compose up -d
   

2. 使用 MCP CLI 與服務器交互：

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

基礎用法

# 倉庫包含的示例 Terraform 配置，用於在 AWS 上創建 EC2 實例
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
  }
}

📚 詳細文檔

可用工具

🤝 貢獻

1. 叉倉庫
2. 創建功能分支
3. 提交你的更改
4. 推送到分支
5. 創建拉取請求

📄 許可證

此項目根據 MIT 許可證發佈，具體內容見 LICENSE 文件。