Facets Module
About
Create and manage Terraform modules for cloud-native infrastructure using the Facets.cloud FTF CLI.
Details
- Author
- facets-cloud
- Categories
- Developer Tools, Infrastructure, Other
Jump to
Note: Similar setup is available in Cursor read](https://readme.facets.cloud/reference/authentication-setup)here
-
Use core tools (list_files,read_file,edit_file_block,write_config_files, etc.) for Terraform code management.
Use FTF CLI integration tools for module scaffolding, validation, and preview workflows.
Complete deployment flow: preview modules withpush_preview_module_to_facets_cp, test on dedicated test projects withtest_already_previewed_module, and monitor progress usingcheck_deployment_statusandget_deployment_logs.
Employ MCP prompts likegenerate_new_moduleto guide module generation interactively, or usefork_existing_moduleto customize existing modules.
All destructive actions require explicit user confirmation and dry-run previews.
The MCP server now supports forking existing modules from the Facets control plane. Use the"Fork Existing Module"prompt to access a guided workflow for:
- Security enhancements: Fork a basic module to add additional security controls or compliance requirements
- Cloud provider adaptations: Adapt modules for different cloud providers while maintaining core functionality
- Performance optimizations: Create high-performance variants of existing modules with enhanced configurations
- Feature customizations: Add organization-specific features or integrations to existing modules
- Version updates: Modernize older modules with updated provider versions or new Terraform features
The fork workflow maintains the original module structure while allowing you to customize metadata, variables, resources, and outputs to meet your specific requirements.
For a comprehensive example of how to use this MCP server with Claude, check out this chat session:Creating a Terraform Module with Facets MCP
This example demonstrates the complete workflow from module generation to testing and deployment.
For a detailed, real-world walkthrough of building a secure S3 bucket module with AI on the Facets platform, check out
GUIDE.md – Building Facets Modules with AI: A Practical Guide
This guide demonstrates the full conversation flow—requirements, design refinement, implementation review, validation, testing, and iteration—using a developer-focused example tailored for a banking use case.
This project is licensed under the MIT License. You are free to use, modify, and distribute it under its terms.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
HashiCorp Terraform MCP server for Infrastructure as Code workflows, including provider and module discovery through the Terraform Registry.
Manage your Bedrock server with natural language commands using the Bedrock Server Manager API.
Verified GPU compute for humans, applications, and agents.
Manages Infrastructure as Code (IaC) operations using Ansible and Terraform. Requires external tools and manual setup.
A Model Context Protocol (MCP) server for accessing the OpenTofu Registry.
Execute Terraform commands locally in a secure, containerized environment. Features LSP integration for intelligent Terraform development.
Core AWS MCP server providing prompt understanding and server management capabilities.
Manage and interact with Microsoft Azure services.
Generate and execute AWS CLI commands using natural language.
A natural language interface to manage AWS services like RDS, S3, EC2, and VPC.
⚠️ DEPRECATED: This repository is no longer actively maintained. Please use Praxis instead. If you need this functionality outside of Praxis, use theRaptor CLI.
This MCP (Model Context Protocol) Server for the Facets Module assists in creating and managing Terraform modules for infrastructure as code. It integrates with Facets.cloud's FTF CLI, providing secure and robust tools for module generation, validation, and management to support cloud-native infrastructure workflows.
-
Secure File Operations
Limits all file operations to within the working directory to ensure safety and integrity.
Modular MCP Tools
Offers comprehensive tools for file listing, reading, writing, module generation, validation, and previews. All destructive or irreversible commands require explicit user confirmation and support dry-run previews.
Facets Module Generation
Interactive prompt-driven workflows facilitate generation of Terraform modules with metadata, variable, and input management using FTF CLI.
Module Forking
Fork existing modules from the Facets control plane to create customized variants. Supports discovering available modules, updating metadata, and customizing functionality while preserving the original module structure.
Supplementary Instructions Support
Automatically reads additional project-specific instructions from themcp_instructionsdirectory at the root level, allowing teams to define custom requirements, constraints, and guidelines that supplement the default module generation behavior.
Module Preview and Testing
Comprehensive deployment workflow supporting module preview, testing in dedicated test projects, and real-time deployment monitoring with status checks and logs. You will need a test project with a running environment and an enabled resource added for the module being tested (to be done manually from the Facets UI).
Cloud Environment Integration
Supports multiple cloud providers and automatically extracts git repository metadata to enrich module previews.
The MCP Server requiresuvfor MCP orchestration.
The package is available on PyPI:facets-module-mcp
For other methods, see theofficial uv installation guide.
Add the following to yourclaude_desktop_config.json:
{ "mcpServers": { "facets-module": { "command": "uvx", "args": [ "facets-module-mcp@latest", "/Path/to/working-directory" ], "env": { "FACETS_PROFILE": "default", "FACETS_USERNAME": "<YOUR_USERNAME>", "FACETS_TOKEN": "<YOUR_TOKEN>", "CONTROL_PLANE_URL": "<YOUR_CONTROL_PLANE_URL>" } } } }
{ "mcpServers": { "facets-module": { "command": "uv", "args": [ "--directory", "/path/to/your/cloned/facets-module-mcp/facets_mcp", "run", "facets_server.py", "/path/to/working-directory" ], "env": { "PYTHONUNBUFFERED": "1", "FACETS_PROFILE": "default", "FACETS_USERNAME": "<YOUR_USERNAME>", "FACETS_TOKEN": "<YOUR_TOKEN>", "CONTROL_PLANE_URL": "<YOUR_CONTROL_PLANE_URL>" } } } }
⚠ Replace<YOUR_USERNAME>,<YOUR_TOKEN>, and<YOUR_CONTROL_PLANE_URL>with your actual authentication data.
Theuvrunner automatically manages environment and dependency setup using thepyproject.tomlfile in the MCP directory.
If you have already logged into FTF, specifyingFACETS_PROFILEis sufficient.
For token generation and authentication setup, please refer to the official Facets documentation:
https://readme.facets.cloud/reference/authentication-setup
Note: Similar setup is available in Cursor readhere
-
Use core tools (list_files,read_file,edit_file_block,write_config_files, etc.) for Terraform code management.
Use FTF CLI integration tools for module scaffolding, validation, and preview workflows.
Complete deployment flow: preview modules withpush_preview_module_to_facets_cp, test on dedicated test projects withtest_already_previewed_module, and monitor progress usingcheck_deployment_statusandget_deployment_logs.
Employ MCP prompts likegenerate_new_moduleto guide module generation interactively, or usefork_existing_moduleto customize existing modules.
All destructive actions require explicit user confirmation and dry-run previews.
The MCP server now supports forking existing modules from the Facets control plane. Use the"Fork Existing Module"prompt to access a guided workflow for:
- Security enhancements: Fork a basic module to add additional security controls or compliance requirements
- Cloud provider adaptations: Adapt modules for different cloud providers while maintaining core functionality
- Performance optimizations: Create high-performance variants of existing modules with enhanced configurations
- Feature customizations: Add organization-specific features or integrations to existing modules
- Version updates: Modernize older modules with updated provider versions or new Terraform features
The fork workflow maintains the original module structure while allowing you to customize metadata, variables, resources, and outputs to meet your specific requirements.
For a comprehensive example of how to use this MCP server with Claude, check out this chat session:Creating a Terraform Module with Facets MCP
This example demonstrates the complete workflow from module generation to testing and deployment.
For a detailed, real-world walkthrough of building a secure S3 bucket module with AI on the Facets platform, check out
GUIDE.md – Building Facets Modules with AI: A Practical Guide
This guide demonstrates the full conversation flow—requirements, design refinement, implementation review, validation, testing, and iteration—using a developer-focused example tailored for a banking use case.
This project is licensed under the MIT License. You are free to use, modify, and distribute it under its terms.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
HashiCorp Terraform MCP server for Infrastructure as Code workflows, including provider and module discovery through the Terraform Registry.
Manage your Bedrock server with natural language commands using the Bedrock Server Manager API.
Verified GPU compute for humans, applications, and agents.
Manages Infrastructure as Code (IaC) operations using Ansible and Terraform. Requires external tools and manual setup.
A Model Context Protocol (MCP) server for accessing the OpenTofu Registry.
Execute Terraform commands locally in a secure, containerized environment. Features LSP integration for intelligent Terraform development.
Core AWS MCP server providing prompt understanding and server management capabilities.
Manage and interact with Microsoft Azure services.
Generate and execute AWS CLI commands using natural language.
A natural language interface to manage AWS services like RDS, S3, EC2, and VPC.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





