MCP 服务器

tfmcp

🌍 Terraform 模型上下文协议 (MCP) 工具 - 一个实验性的 CLI 工具，使 AI 助手能够管理和操作 Terraform 环境。支持读取 Terraform 配置、分析计划、应用配置以及使用 Claude Desktop 集成管理状态。⚡️

README

tfmcp: Terraform 模型上下文协议工具

⚠️ 本项目为实验性项目。功能可能会在没有通知的情况下更改。请谨慎使用！ ⚠️

tfmcp 是一个命令行工具，可帮助您通过模型上下文协议 (MCP) 与 Terraform 交互。它允许 LLM 管理和操作您的 Terraform 环境，包括：

🎮 演示

观看 tfmcp 与 Claude Desktop 协同工作：

tfmcp Demo with Claude Desktop

读取 Terraform 配置文件
分析 Terraform 计划输出
应用 Terraform 配置
管理 Terraform 状态
创建和修改 Terraform 配置

🎉 最新发布

tfmcp 的第一个稳定版本 (v0.1.1) 现已在 Crates.io 上发布！您可以使用 Cargo 轻松安装它：

cargo install tfmcp

功能

🚀 Terraform 集成
与 Terraform CLI 深度集成，以分析和执行操作。
📄 MCP 服务器功能
作为模型上下文协议服务器运行，允许 AI 助手访问和管理 Terraform。
⚡️ 极速
由 Rust 生态系统提供支持的高速处理。
🛠️ 自动设置
在需要时自动创建示例 Terraform 项目，确保即使对于新用户也能顺利运行。

安装

从源代码

# 克隆仓库
git clone https://github.com/nwiizo/tfmcp
cd tfmcp

# 构建并安装
cargo install --path .

从 Crates.io

cargo install tfmcp

要求

Rust (edition 2021)
已安装 Terraform CLI 且可在 PATH 中访问
Claude Desktop（用于 AI 助手集成）

用法

$ tfmcp --help
✨ 一个通过模型上下文协议 (MCP) 管理 Terraform 配置和操作 Terraform 的 CLI 工具。

用法: tfmcp [OPTIONS] [COMMAND]

命令:
  mcp       将 tfmcp 作为 MCP 服务器启动
  analyze   分析 Terraform 配置
  help      打印此消息或给定子命令的帮助

选项:
  -c, --config <PATH>    配置文件的路径
  -d, --dir <PATH>       Terraform 项目目录
  -V, --version          打印版本
  -h, --help             打印帮助

与 Claude Desktop 集成

要将 tfmcp 与 Claude Desktop 一起使用：

如果您尚未安装 tfmcp，请安装：
```
cargo install tfmcp
```
找到已安装的 tfmcp 可执行文件的路径：
```
which tfmcp
```
将以下配置添加到 ~/Library/Application\ Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "tfmcp": {
      "command": "/path/to/your/tfmcp",  // 替换为步骤 2 中的实际路径
      "args": ["mcp"],
      "env": {
        "HOME": "/Users/yourusername",  // 替换为您的用户名
        "PATH": "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin",
        "TERRAFORM_DIR": "/path/to/your/terraform/project"  // 可选：指定您的 Terraform 项目
      }
    }
  }
}

重新启动 Claude Desktop 并启用 tfmcp 工具。
如果不存在，tfmcp 将自动在 ~/terraform 中创建一个示例 Terraform 项目，确保 Claude 可以立即开始使用 Terraform。该示例项目基于此存储库的 example/demo 目录中包含的示例。

日志和故障排除

tfmcp 服务器日志位于：

~/Library/Logs/Claude/mcp-server-tfmcp.log

常见问题和解决方案：

Claude 无法连接到服务器：确保 tfmcp 可执行文件的路径在您的配置中正确
Terraform 项目问题：如果未找到 Terraform 项目，tfmcp 会自动创建一个示例 Terraform 项目
找不到方法错误：MCP 协议支持 resources/list 和 prompts/list 方法

环境变量

TERRAFORM_DIR：设置此变量以指定自定义 Terraform 项目目录。如果未设置，tfmcp 将使用命令行参数、配置文件提供的目录，或者回退到 ~/terraform。您还可以使用 set_terraform_directory 工具在运行时更改项目目录。
TFMCP_LOG_LEVEL：设置为 debug、info、warn 或 error 以控制日志记录详细程度。
TFMCP_DEMO_MODE：设置为 true 以启用具有附加安全功能的演示模式。