Terraform Registry MCP 服务器

这是一个提供与 Terraform Registry API 交互工具的 Model Context Protocol (MCP) 服务器。该服务器使 AI 代理能够查询提供商信息、资源详情和模块元数据。

安装

在 Cursor 中安装

要在 Cursor 中安装并使用此 MCP 服务器：

1. 在 Cursor 中，打开设置（⌘+,）并导航到“MCP”选项卡。

2. 点击“+ 添加新的 MCP 服务器”。

3. 输入以下内容：

   • 名称：terraform-registry
   • 类型：command
   • 命令：npx -y terraform-mcp-server

4. 点击“添加”，然后滚动到服务器并点击“禁用”以启用服务器。

5. 如果需要，请重启 Cursor 以确保 MCP 服务器正确加载。

在 Claude Desktop 中安装

要在 Claude Desktop 中安装并使用此 MCP 服务器：

1. 在 Claude Desktop 中，打开设置（⌘+,）并导航到“开发者”选项卡。

2. 点击窗口底部的“编辑配置”。

3. 编辑文件（~/Library/Application Support/Claude/claude_desktop_config.json）以添加以下代码，然后保存文件。

{
  "mcpServers": {
    "terraform-registry": {
      "command": "npx",
      "args": ["-y", "terraform-mcp-server"]
    }
  }
}

1. 重启 Claude Desktop 以确保 MCP 服务器正确加载。

工具

此 MCP 服务器中提供了以下工具：

核心注册表工具

Terraform Cloud 工具

这些工具需要一个 Terraform Cloud API 令牌 (TFC_TOKEN)：

资源

MCP 服务器通过 resources/* 方法支持以下用于列出和读取的资源 URI：

服务器还支持 resources/templates/list 以提供创建以下项的模板：

• terraform:provider
• terraform:resource
• terraform:dataSource

提示

以下提示可用于生成上下文响应：

提示已知问题

注意：getPrompt 功能存在一个已知问题，可能会导致服务器崩溃。服务器可以正确注册提示并列出它们，但直接使用 getPrompt 方法可能引起连接问题。此问题正在调查中，可能与 SDK 兼容性或实现细节有关。在解决之前，请使用 listPrompts 查看可用提示，但避免直接调用 getPrompt。

运行服务器

服务器使用 stdio 传输进行 MCP 通信：

npm install
npm start

使用环境变量配置

可以通过环境变量来配置服务器：

使用环境变量的示例：

# Set environment variables
export LOG_LEVEL="debug"
export REQUEST_TIMEOUT_MS="15000"
export TFC_TOKEN="your-terraform-cloud-token"

# Run the server
npm start

测试

关于本项目的测试信息，请参阅 TESTS.md 文件。