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 文件。