Terraform Registry MCP Server
2025.03.31
64
TypeScriptTerraform 管理基础设施即代码开发效率
Terraform Registry MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，主要用于与 Terraform Registry API 进行交互。它使 AI 代理能够查询 Terraform 提供者信息、资源详情和模块元数据。该服务器提供了一系列工具，用于获取和管理 Terraform 相关的各种资源，包括提供者、模块、数据源、函数等。此外，它还支持 Terraform Cloud 的相关操作，如管理工作区、运行等。
View on GitHub
Overview
基本能力
产品定位
Terraform Registry MCP Server 是一个专门为 Terraform 生态系统设计的 MCP 服务器，旨在提供对 Terraform Registry API 的便捷访问和管理功能。
核心功能
- 核心注册表工具：
- 获取 Terraform 提供者的详细信息
- 查询 Terraform 资源的示例用法
- 搜索和推荐 Terraform 模块
- 列出提供者的所有可用数据源
- 获取资源类型参数的详细信息
- 检索 Terraform 模块的详细元数据
- 获取 Terraform 提供者函数的详细信息
- 列出和查看提供者特定的指南和文档
- 搜索策略库
-
获取特定策略库的详细信息
-
Terraform Cloud 工具（需要 Terraform Cloud API 令牌）：
- 列出用户有权访问的所有组织
- 搜索组织中的私有模块
- 获取私有模块的详细信息
- 查询 Terraform Cloud Explorer API 以分析数据
- 列出组织中的工作区
- 获取特定工作区的详细信息
- 锁定/解锁工作区
- 列出工作区的运行
- 获取特定运行的详细信息
- 创建工作区的新运行
- 应用已计划的运行
- 取消正在进行的运行
-
列出工作区中的资源
-
资源 URI 支持：
- 提供者
- 提供者版本
- 提供者资源
- 提供者数据源
-
提供者函数
-
提示功能：
- 生成在云提供商之间迁移基础设施的 Terraform 代码
- 帮助用户快速搭建新的 Terraform 资源
- 提供改进 Terraform 代码的可操作建议
- 协助提供者版本升级和重大变更
- 分析最近的运行失败并提供故障排除指导
适用场景
- Terraform 基础设施即代码开发
- Terraform 模块和提供者管理
- Terraform Cloud 工作区管理
- 跨云基础设施迁移
- Terraform 代码优化和重构
使用教程
使用依赖
- 确保已安装 Node.js 和 npm
- 确保已安装 Cursor 或 Claude Desktop（根据使用环境选择）
安装教程
在 Cursor 中安装
- 在 Cursor 中打开设置 (⌘+,) 并导航到 "MCP" 选项卡
- 点击 "+ Add new MCP server"
- 输入以下信息：
- Name: terraform-registry
- Type: command
- Command: npx -y terraform-mcp-server
- 点击 "Add"，然后滚动到服务器并点击 "Disabled" 以启用服务器
- 如果需要，重新启动 Cursor 以确保 MCP 服务器正确加载
在 Claude Desktop 中安装
- 在 Claude Desktop 中打开设置 (⌘+,) 并导航到 "Developer" 选项卡
- 点击窗口底部的 "Edit Config"
- 编辑文件 (
~/Library/Application Support/Claude/claude_desktop_config.json) 添加以下代码，然后保存文件
{
"mcpServers": {
"terraform-registry": {
"command": "npx",
"args": ["-y", "terraform-mcp-server"]
}
}
}
- 重新启动 Claude Desktop 以确保 MCP 服务器正确加载
调试方式
- 安装依赖：
npm install
- 运行服务器：
npm start
- 设置环境变量（可选）：
export LOG_LEVEL="debug"
export REQUEST_TIMEOUT_MS="15000"
export TFC_TOKEN="your-terraform-cloud-token"
- 然后运行服务器：
npm start