Terry-Form MCP

Terry Form MCP

通过模型上下文协议实现人工智能驱动的地形执行。

  ](https://github.com/aj-geddes/terry-form-mcp/blob/main/Dockerfile) 

Terry Form MCP是一个集装箱 模型上下文协议 服务器，为克劳德等人工智能助手提供对Terraform的安全、结构化访问。它公开了25个MCP工具，涵盖了Terraform执行、LSP智能、GitHub集成和Terraform Cloud连接——所有这些工具都在Docker中运行，设计阻止了破坏性操作。

文档网站

______________________________________________________________________

仪表盘

Terry-Form MCP Dashboard

内置的web仪表板提供实时服务器运行状况监控、工具类别概述和集成状态一目了然。实时状态每5秒自动刷新一次。

配置UI

Server Configuration

选项卡式配置界面允许您管理服务器设置、集成、云提供商凭据和速率限制，所有这些都不需要接触配置文件。使用HAT堆栈（HTMX+Alpine.js+Tailwind CSS）构建。

工具目录

Tool Catalog

交互式工具目录位于 /tools 列出了所有25个MCP工具，包括搜索、类别过滤和可扩展参数详细信息。也可作为原始JSON端点在 /api/tools 作为一种静态 tools.json 文件。

______________________________________________________________________

快速开始

先决条件

• Docker已安装并正在运行
• Python>=3.10（用于本地开发）

1.建造

scripts/build.sh      # Linux/macOS
scripts\build.bat     # Windows
# or directly:
docker build -t terry-form-mcp .

2.作为MCP服务器运行

docker run -it --rm \
  -v "$(pwd)":/mnt/workspace \
  terry-form-mcp

3.验证图像

scripts/verify.sh   # Runs 8 checks: Docker, image size, Terraform, terraform-ls, Python, files, tools, startup

______________________________________________________________________

环境变量

所有配置都是通过环境变量进行的。基本使用不需要配置文件。

服务器配置

地形

语言服务器协议

GitHub集成

地形云

速率限制

云提供商通道

这些变量直接转发到Terraform子流程。将它们设置为与您的云提供商进行身份验证。

AWS： AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_DEFAULT_REGION, AWS_REGION, AWS_PROFILE

GCP： GOOGLE_CREDENTIALS, GOOGLE_APPLICATION_CREDENTIALS, GOOGLE_PROJECT, GOOGLE_REGION, GOOGLE_ZONE

Azure： ARM_CLIENT_ID, ARM_CLIENT_SECRET, ARM_SUBSCRIPTION_ID, ARM_TENANT_ID

______________________________________________________________________

MCP客户端配置

将Terry Form添加到任何兼容MCP的客户端：

{
  "mcpServers": {
    "terry": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/path/to/your/workspace:/mnt/workspace",
        "terry-form-mcp"
      ]
    }
  }
}

Platform-specific examples

克劳德桌面（Windows）

{
  "mcpServers": {
    "terry": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "C:\\Users\\YourUsername\\terraform-projects:/mnt/workspace",
        "terry-form-mcp"
      ]
    }
  }
}

克劳德桌面（macOS）

{
  "mcpServers": {
    "terry": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/Users/YourUsername/terraform-projects:/mnt/workspace",
        "terry-form-mcp"
      ]
    }
  }
}

VSCode（使用工作空间变量）

{
  "mcp.servers": {
    "terry": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "${workspaceFolder}:/mnt/workspace",
        "terry-form-mcp"
      ]
    }
  }
}

______________________________________________________________________

工具（25）

核心地形

# Initialize and validate a project
terry(path="infrastructure/aws", actions=["init", "validate"])

# Plan with variables
terry(path="environments/prod", actions=["plan"], vars={"instance_count": "3", "region": "us-east-1"})

仅 init, validate, fmt，以及 plan 是允许的。 apply 和 destroy 被封锁。

LSP情报

# Code completions
terraform_complete(file_path="main.tf", line=10, character=0)

# Hover documentation
terraform_hover(file_path="main.tf", line=15, character=12)

# Detailed validation with error locations
terraform_validate_lsp(file_path="main.tf")

# Format a file
terraform_format_lsp(file_path="main.tf")

由...驱动 terraform-ls v0.38.5--提供上下文感知的补全、内联文档和具有精确源位置的诊断。

GitHub集成

# Clone a repo and prepare it for Terraform operations
github_clone_repo(owner="myorg", repo="infrastructure")
github_prepare_workspace(owner="myorg", repo="infrastructure", config_path="environments/prod")

安全扫描

# Scan for hardcoded credentials, missing encryption, overly permissive policies
terry_security_scan(path="my-project")

# Get actionable improvement recommendations
terry_recommendations(path="my-project")

______________________________________________________________________

建筑

┌─────────────┐     MCP Protocol     ┌──────────────────────────────────────┐
│ AI Assistant │ ◄──────────────────► │  Terry-Form MCP Server               │
│ (Claude)     │                      │                                      │
└─────────────┘                      │  ┌─────────────┐  ┌──────────────┐  │
                                     │  │ Terraform    │  │ terraform-ls │  │
                                     │  │ CLI 1.12     │  │ LSP 0.38.5   │  │
                                     │  └──────┬───────┘  └──────┬───────┘  │
                                     │         │                 │          │
                                     │         ▼                 ▼          │
                                     │  ┌──────────────────────────────┐   │
                                     │  │   /mnt/workspace (isolated)   │   │
                                     │  └──────────────────────────────┘   │
                                     └──────────────────────────────────────┘
                                              Docker Container

关键组件

前端堆栈

内置的web UI使用 HAT堆栈:

• HTMX 2.0——不完全重新加载的部分页面更新
• A.lpine.js 3.14——标签和吐司的轻量级客户端反应
• Tailwind CSS——暗模式优先实用样式

与一起运行时，可在服务器根目录访问 streamable-http 或 sse 运输。

______________________________________________________________________

安全模型

Terry Form采用四层深度防御：

强制环境变量： TF_IN_AUTOMATION=true, TF_INPUT=false, CHECKPOINT_DISABLE=true.

______________________________________________________________________

使用Web UI运行

要使用仪表板和配置UI，请使用HTTP传输运行：

# Local
MCP_TRANSPORT=streamable-http HOST=0.0.0.0 PORT=8000 python3 src/server_enhanced_with_lsp.py

# Docker
docker run -it --rm \
  -p 8000:8000 \
  -v "$(pwd)":/mnt/workspace \
  -e MCP_TRANSPORT=streamable-http \
  terry-form-mcp

然后打开 http://localhost:8000 在您的浏览器中。

配置选项卡

______________________________________________________________________

集装箱详情

建立在 hashicorp/terraform:1.12 （基于阿尔卑斯山，~150MB）。包括：

• Terraform CLI 1.12
• terraform-ls v0.38.5用于LSP支持
• Python 3.12与FastMCP 3.0+
• 以非root用户身份运行 terraform （UID 1001）

______________________________________________________________________

发展

# Install dependencies
pip install -r requirements.txt

# Run locally
python3 src/server_enhanced_with_lsp.py

# Code quality
black .       # Format (88-char line limit)
flake8 .      # Lint
mypy src/*.py # Type check

______________________________________________________________________

局限性

• 无状态修改 — apply 和 destroy 被故意封锁
• 仅字符串变量 --CLI直通不支持复杂变量类型
• LSP冷启动 --第一次LSP操作需要1-2秒进行初始化
• 本地执行 --专为开发工作流程而非生产CI/CD而设计

______________________________________________________________________

许可证

麻省理工学院