MCP 服务器

MCP Infrastructure as Code Assistant

一个用于使用 Terraform 管理基础设施即代码的 MCP 服务器。

guilhermeyoshida

开发者工具

访问服务器

README

MCP 基础设施即代码助手

一个用于使用 Terraform 管理基础设施即代码的 MCP 服务器。

功能

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

前提条件

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

安装

本地安装

克隆存储库：

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

使用 uv 安装依赖项：

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

Docker 安装

克隆存储库：

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

构建并运行 Docker 容器：
```
docker-compose up -d
```

用法

本地用法

启动 MCP 服务器：
```
python main.py
```

使用 MCP CLI 与服务器交互：

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

Docker 用法

启动 MCP 服务器：
```
docker-compose up -d
```

使用 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
  }
}

贡献

Fork 存储库
创建一个功能分支
提交您的更改
推送到分支
创建一个 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 代理一起使用的示例：

启动 MCP 服务器：
```
python main.py
```
使用 MCP 客户端连接到服务器：
```
mcp connect http://localhost:8000
```
AI 代理现在可以帮助您进行 Terraform 操作。例如：
- 初始化 Terraform 工作目录
- 生成并审查执行计划
- 将更改应用到基础设施
- 销毁基础设施资源
- 验证 Terraform 配置