Skip to content

Releases: aj-geddes/terry-form-mcp

v3.0.0 - Production Ready

Choose a tag to compare

@aj-geddes aj-geddes released this 05 Oct 21:23

🎯 Major Release - Production Ready

This release represents a complete refactoring and cleanup of the Terry-Form MCP codebase, resulting in a focused, production-ready single-server architecture with comprehensive documentation.

✨ Added

  • Complete Tool Coverage: All 25 MCP tools now fully documented

    • Core Terraform Tools (4): terry, terry_version, terry_environment_check, terry_workspace_list
    • LSP Intelligence (5): terraform_validate_lsp, terraform_hover, terraform_complete, terraform_format_lsp, terraform_lsp_status
    • Diagnostic Tools (6): terry_lsp_debug, terry_workspace_info, terry_lsp_init, terry_file_check, terry_workspace_setup, terry_analyze
    • Intelligence Tools (2): terry_recommendations, terry_security_scan
    • GitHub Integration (4): github_clone_repo, github_list_terraform_files, github_get_terraform_config, github_prepare_workspace
    • Terraform Cloud (4): tf_cloud_list_workspaces, tf_cloud_get_workspace, tf_cloud_list_runs, tf_cloud_get_state_outputs
  • Production Tooling:

    • verify.sh - Comprehensive 8-step verification script
    • QUICKSTART.md - Complete quick start guide
    • Enhanced security validation with mcp_request_validator.py
    • Rate limiting and authentication framework

🔄 Changed

  • Single Server Architecture: Consolidated from 3 server variants to one focused server

    • server_enhanced_with_lsp.py - Single point of entry with all features
    • Removed server_mcp_only.py (had missing dependencies)
    • Removed server_web_only.py (unused)
  • Clean Codebase: Removed all legacy and unused code

    • Removed terry-form-mcp.py (old standalone script)
    • Removed internal/ directory (empty stub modules)
    • Removed broken tests/ directory
    • Docker image now copies only 5 required Python files
  • Documentation Overhaul:

    • README.md: Added documentation for all 13 previously undocumented tools
    • docs/_api/mcp-tools.md: Complete reference for all 25 tools with examples
    • docs/index.md: Updated for v3.0.0 features
    • Removed all false claims about non-existent features

🔧 Fixed

  • Dockerfile:

    • Removed legacy files from COPY commands
    • Fixed health check for stdio MCP protocol
    • Added all required supporting files
  • Documentation Accuracy:

    • Removed claims about non-existent features
    • Updated all server file references
    • Fixed Docker installation instructions

🔒 Security

  • Enhanced input validation and sanitization
  • Path traversal protection
  • Command injection prevention
  • Rate limiting (100 req/min default, 20 req/min for Terraform operations)
  • Optional API key authentication

⚠️ Breaking Changes

  • Removed server_mcp_only.py and server_web_only.py - use server_enhanced_with_lsp.py only
  • Removed internal/ module structure - all code now in root-level modules

📦 Installation

Docker (Recommended):
```bash
docker build -t terry-form-mcp .
docker run -i --rm -v ./workspace:/mnt/workspace terry-form-mcp
```

Claude Desktop Configuration:
```json
{
"mcpServers": {
"terry-form": {
"command": "docker",
"args": ["run", "-i", "--rm", "-v", "./workspace:/mnt/workspace", "terry-form-mcp"]
}
}
}
```

See QUICKSTART.md for complete setup instructions.


Full Changelog: v2.0.0...v3.0.0

v2.0.0 - LSP Integration

Choose a tag to compare

@aj-geddes aj-geddes released this 11 Jun 05:00

Terry-Form MCP v2.0.0 - LSP Integration

Major Enhancements

Added

  • Comprehensive Language Server Protocol (LSP) integration
  • Intelligent code completion, documentation, and validation
  • 6 new diagnostic tools for environment and workspace analysis
    • terry_environment_check: Comprehensive checks for Terraform and LSP setup
    • terry_lsp_debug: Detailed status information about the Language Server
    • terry_workspace_info: Terraform project structure and readiness assessment
    • terry_lsp_init: Manual control over LSP client setup
    • terry_file_check: Terraform file syntax and structure checking
    • terry_workspace_setup: Automated creation of properly structured Terraform projects
  • Enhanced Dockerfile with terraform-ls v0.33.2

Changed

  • Consolidated multiple Dockerfiles into a single Dockerfile
  • Consolidated build scripts into build.sh and build.bat
  • Improved error handling and workspace management
  • Updated documentation with new LSP features and examples

Fixed

  • LSP client initialization and stability improvements
  • Enhanced error handling with detailed error messages
  • Improved timeout handling for LSP operations

Key Advantages of LSP Integration

The LSP integration provides several significant advantages over the basic Terraform execution:

  1. Intelligent Code Assistance: Get real-time documentation, completions, and validation as you develop, reducing errors and speeding up development.

  2. Enhanced Diagnostics: Receive detailed diagnostic information with precise locations and explanations, making it easier to fix issues.

  3. Provider-Aware: LSP understands your provider context, offering provider-specific completions and documentation.

  4. Workspace Context: LSP maintains awareness of your entire project structure, enabling smarter suggestions and validations.

  5. Development Speed: Reduce the feedback loop between writing code and validating it, speeding up infrastructure development.

Get Started

See the updated [README.md](https://github.com/aj-geddes/terry-form-mcp/blob/main/README.md) for installation and usage instructions.

# Build using the provided script (Linux/macOS)
./build.sh

# Or for Windows users
build.bat

# Run as MCP server
docker run -it --rm \
  -v "$(pwd)":/mnt/workspace \
  terry-form-mcp

Configuration

Example Claude Desktop configuration:

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

Full Changelog: https://github.com/aj-geddes/terry-form-mcp/commits/v2.0.0