Terraform MCP 助手

一个基于 FastMCP 的服务器，提供自然语言接口来操作 Terraform。 这个助手允许你使用简单的英语命令来管理你的基础设施，而无需记住特定的 Terraform 语法。

特性

• Terraform 命令的自然语言处理
• 执行计划可视化
• 状态检查和管理
• 基础设施部署和销毁
• 配置文档
• 自动工作区验证
• 错误处理和格式化输出

安装

1. 克隆仓库:

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

2. 创建并激活虚拟环境:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. 安装依赖:

pip install -r requirements.txt

4. 可选: 安装 Graphviz 用于计划可视化:

• Windows: 从 Graphviz Download Page 下载
• Linux: sudo apt-get install graphviz
• macOS: brew install graphviz

配置

1. 设置环境变量 (可选):

export TERRAFORM_WORKSPACE="/path/to/terraform/workspace"
export LOG_LEVEL="INFO"

2. 将你的 Terraform 配置文件放在工作区目录中。

使用

1. 启动 MCP 服务器:

python src/main.py

2. 示例命令:

• "初始化 Terraform 工作区"
• "如果我应用会发生什么变化？"
• "显示我当前状态"
• "应用配置"
• "列出所有资源"
• "销毁基础设施"

项目结构

terraform-mcp-assistant/
├── docs/                     # 文档
├── examples/                 # 示例 Terraform 配置
├── src/                      # 源代码
│   ├── handlers/             # 命令处理器
│   ├── main.py               # 入口点
│   └── config.py             # 配置管理
├── tests/                    # 测试文件
├── .env                      # 环境变量 (不在 VCS 中)
└── README.md                 # 本文件

开发

1. 安装开发依赖:

pip install -r requirements-dev.txt

2. 运行测试:

pytest

贡献

1. Fork 仓库
2. 创建一个特性分支
3. 提交你的更改
4. 推送到分支
5. 创建一个 Pull Request