Releases: aj-geddes/terry-form-mcp
Release list
v3.0.0 - Production Ready
🎯 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
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 setupterry_lsp_debug: Detailed status information about the Language Serverterry_workspace_info: Terraform project structure and readiness assessmentterry_lsp_init: Manual control over LSP client setupterry_file_check: Terraform file syntax and structure checkingterry_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:
-
Intelligent Code Assistance: Get real-time documentation, completions, and validation as you develop, reducing errors and speeding up development.
-
Enhanced Diagnostics: Receive detailed diagnostic information with precise locations and explanations, making it easier to fix issues.
-
Provider-Aware: LSP understands your provider context, offering provider-specific completions and documentation.
-
Workspace Context: LSP maintains awareness of your entire project structure, enabling smarter suggestions and validations.
-
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-mcpConfiguration
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