MCP Infrastructure as Code Assistant

MCP 基础设施即代码助手

用于通过 Terraform 管理基础设施即代码的 MCP 服务。

功能

• 初始化 Terraform 工作目录
• 生成并显示执行计划
• 应用基础设施更改
• 销毁基础设施
• 验证 Terraform 配置
• 显示当前状态或已保存的计划
• 管理 Terraform 工作区

先决条件

• Python 3.8 或更高版本
• Terraform 1.5.7 或更高版本
• Docker 和 Docker Compose（可选）

安装

本地安装

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 配置示例

仓库中包含一个 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. Fork 仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

可用工具

• terraform_init：初始化 Terraform 工作目录
• terraform_plan：生成并显示 Terraform 执行计划
• terraform_apply：应用为达到期望状态所需的更改
• terraform_destroy：销毁由 Terraform 管理的基础设施
• terraform_validate：验证 Terraform 文件的语法和内部一致性
• terraform_show：显示当前状态或已保存的计划
• terraform_workspace_list：列出 Terraform 工作区
• terraform_workspace_select：选择 Terraform 工作区

用法示例

以下示例展示了如何将 MCP 服务与 AI Agent 配合使用：

1. 启动 MCP 服务：

   python main.py
   

2. 使用 MCP 客户端连接到服务：

   mcp connect http://localhost:8000
   

3. AI Agent 现在可以协助你执行 Terraform 操作。例如：

   • 初始化 Terraform 工作目录
   • 生成并审查执行计划
   • 应用基础设施更改
   • 销毁基础设施资源
   • 验证 Terraform 配置

示例

查看 examples 目录中的 Terraform 配置示例，了解如何使用 MCP 服务：

• examples/aws-s3：一个简单的 AWS S3 存储桶示例