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  # 在Windows上：.venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

4. 可选：安装Graphviz以进行计划可视化：

• Windows：从Graphviz下载页面下载
• 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                # 环境变量（不在版本控制系统中）
└── README.md           # 此文件

开发

1. 安装开发依赖项：

pip install -r requirements-dev.txt

2. 运行测试：

pytest

贡献

1. 分叉仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建拉取请求