Power your agent
Lệnh của chính nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
npx -y @downatthebottomofthemolehole/[email protected]Claude Code không có liên kết cài đặt cho lệnh cục bộ. Sao chép lệnh bên dưới và chạy trong terminal.
claude mcp add downatthebottomofthemolehole-terraform-best-practices-mcp-server -- npx -y @downatthebottomofthemolehole/terraform-best-practices-mcp-server@5.2.65Chạy trong terminal.
{ "mcpServers": { "downatthebottomofthemolehole-terraform-best-practices-mcp-server": { "command": "npx", "args": [ "-y", "@downatthebottomofthemolehole/[email protected]" ] } }}claude_desktop_config.json
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
MởNote: This is a community-maintained MCP server. It is not an official Model Context Protocol server from HashiCorp or any cloud provider.
A Model Context Protocol (MCP) server for producing better Terraform through CLI analysis (tflint, checkov, trivy, kics, infracost), best-practice guidance from terraform-best-practices.com, cloud provider recommendations (Azure, AWS, GCP), and Terraform Registry resource and module guidance.
This server provides eighteen MCP tools across CLI analysis, best-practice retrieval, and interactive reporting workflows:
run_tflint to lint Terraform code.run_checkov to run security and compliance scanning.run_trivy to scan Terraform configuration for vulnerabilities.run_kics to run IaC security and compliance scanning.run_infracost to estimate cloud costs.fetch_terraform_best_practices to retrieve curated Terraform best practices.fetch_provider_best_practices to retrieve cloud provider Terraform guidance.fetch_terraform_registry_guidance to retrieve Terraform Registry resource and module guidance.analyze_terraform_code to analyze code structure, modularity, and best practices.analyze_terraform_performance to identify runtime and performance bottlenecks.analyze_state_management to assess backend state strategy and collaboration safety.generate_cost_report to generate cost analysis with optimization suggestions.generate_terraform_module_docs to produce module documentation from Terraform code.recommend_terraform_modules to recommend reusable modules from detected patterns.suggest_terraform_architecture to suggest multi-environment and multi-region patterns.suggest_terraform_testing_strategy to recommend CI-driven testing by risk profile.suggest_security_hardening to provide security hardening recommendations.generate_compliance_summary to create compliance reports from scan outputs.This MCP server is platform-agnostic and works in local and CI environments:
The primary requirements are Node.js and optionally the CLI tools on PATH. If a CLI is missing, the server returns installation guidance instead of failing silently.
run_tflintRun tflint against a Terraform project directory.
Inputs:
path (string, optional): Terraform project path to scan. Default: ..extraArgs (string[], optional): Extra CLI arguments.timeoutMs (integer, optional): Command timeout in milliseconds.run_checkovRun checkov over a Terraform directory.
Inputs:
path (string, optional): Terraform project path to scan. Default: ..extraArgs (string[], optional): Extra CLI arguments.timeoutMs (integer, optional): Command timeout in milliseconds.run_trivyRun trivy config scanning against Terraform code.
Inputs:
path (string, optional): Terraform project path to scan. Default: ..extraArgs (string[], optional): Extra CLI arguments.timeoutMs (integer, optional): Command timeout in milliseconds.run_kicsRun kics IaC scanning against Terraform code.
Inputs:
path (string, optional): Terraform project path to scan. Default: ..extraArgs (string[], optional): Extra CLI arguments.timeoutMs (integer, optional): Command timeout in milliseconds.run_infracostRun infracost breakdown for a Terraform directory.
Inputs:
path (string, optional): Terraform project path to scan. Default: ..extraArgs (string[], optional): Extra CLI arguments.timeoutMs (integer, optional): Command timeout in milliseconds.fetch_terraform_best_practicesFetch Terraform best-practice guidance from curated checks and optional live summaries from terraform-best-practices.com.
Inputs:
topic (string, optional): Topic filter such as state, modules, security, or naming.liveFetch (boolean, optional): When true, fetches and summarises live content. Default: true.fetch_provider_best_practicesFetch Terraform best-practice guidance for Azure, AWS, or GCP from curated checks and optional live provider docs summaries.
Inputs:
provider (string, required): Cloud provider (azure, aws, or gcp).topic (string, optional): Focus area such as state, IAM, modules, networking, or cost.liveFetch (boolean, optional): When true, fetches and summarises the linked provider guidance page. Default: true.fetch_terraform_registry_guidanceFetch Terraform Registry guidance for providers, resources, and modules.
Inputs:
provider (string, optional): Provider name (e.g. aws, azurerm, google).resource (string, optional): Resource type used with provider (e.g. s3_bucket, resource_group).module (string, optional): Module path in the form namespace/name/provider.topic (string, optional): Topic filter for the summary output.liveFetch (boolean, optional): When true, fetches and summarises selected Registry pages. Default: true.analyze_terraform_codeAnalyze Terraform code structure, modularity, and best practices.
Inputs:
code (string, required): Terraform code snippet to analyze (max 50,000 chars).focusArea (string, optional): Analysis focus area (modularity, variables, outputs, locals, general). Default: general.analyze_terraform_performanceAnalyze Terraform runtime and performance bottlenecks and optimization opportunities.
Inputs:
terraformCode (string, required): Terraform code for performance-focused heuristics.stateSizeMb (number, optional): State size in MB for scale-aware recommendations.workspaceCount (integer, optional): Number of workspaces sharing the same root stack.providerRateLimitSensitive (boolean, optional): When true, emphasise provider API throttling protections. Default: true.analyze_state_managementAssess backend state strategy and collaboration safety.
Inputs:
terraformCode (string, required): Terraform code including backend and state-related configuration.teamSize (integer, optional): Number of engineers applying Terraform changes. Default: 6.environmentCount (integer, optional): Number of environments managed by the estate. Default: 2.currentBackend (string, optional): State backend in use (auto, s3, azurerm, gcs, remote, local, unknown). Default: auto.useWorkspaces (boolean, optional): Whether multiple environments are managed through workspaces. Default: false.generate_cost_reportGenerate cost analysis with optimization suggestions from Infracost output.
Inputs:
infracostJson (string, required): JSON output from infracost breakdown or diff command.includeOptimizations (boolean, optional): When true, generates cost optimization suggestions. Default: true.generate_terraform_module_docsGenerate module documentation markdown from Terraform code.
Inputs:
terraformCode (string, required): Terraform module code to document.moduleName (string, optional): Friendly name used in generated markdown docs. Default: terraform-module.includeUsageExample (boolean, optional): Include a usage example section. Default: true.includeInputsOutputsTables (boolean, optional): Render inputs and outputs as markdown tables. Default: true.recommend_terraform_modulesRecommend reusable Terraform modules from detected code patterns.
Inputs:
terraformCode (string, required): Terraform code used to infer module recommendations.provider (string, optional): Preferred cloud provider (aws, azure, gcp, any). Default: any.deploymentIntent (string, optional): Primary deployment goal (networking, kubernetes, serverless, storage, database, observability, security, general). Default: general.maxRecommendations (integer, optional): Maximum recommendations to return (1--10). Default: 5.suggest_terraform_architectureSuggest architecture patterns for multi-environment and multi-region estates.
Inputs:
workloadType (string, optional): Primary workload profile (web-api, data-platform, event-driven, platform-foundation, general). Default: general.environments (string[], optional): Target environments (dev, test, stage, prod, sandbox, dr). Default: ["dev", "prod"].multiRegion (boolean, optional): Whether workloads run across multiple regions. Default: false.complianceProfile (string, optional): Compliance profile (none, cis, pci-dss, hipaa, sox). Default: none.teamSize (integer, optional): Number of engineers operating Terraform code. Default: 6.currentPainPoints (string, optional): Pain points or constraints in the current architecture.includeReferenceLayout (boolean, optional): Include a suggested repository and folder layout. Default: true.suggest_terraform_testing_strategyRecommend CI-driven Terraform testing strategy by risk profile.
Inputs:
terraformCode (string, optional): Terraform code for complexity-aware recommendations.deploymentCriticality (string, optional): Business impact level (low, medium, high, mission-critical). Default: medium.changeFrequency (string, optional): How often infrastructure changes are introduced (low, medium, high). Default: medium.ciSystem (string, optional): Target CI system (github-actions, azure-devops, gitlab, circleci, jenkins, other). Default: github-actions.includeExamplePipeline (boolean, optional): Include an example pipeline sequence. Default: true.suggest_security_hardeningProvide security hardening recommendations from scan output.
Inputs:
scanOutput (string, required): Output from a security scanning tool (checkov, trivy, or kics).scanTool (string, optional): Name of the scanning tool (checkov, trivy, kics). Default: checkov.generate_compliance_summaryCreate compliance reports from scan outputs.
Inputs:
checkovOutput (string, optional): Output from checkov scan.trivyOutput (string, optional): Output from trivy scan.kicsOutput (string, optional): Output from kics scan.complianceFramework (string, optional): Compliance framework to assess against (cis, pci-dss, hipaa, sox, general). Default: general.Use these minimal prompts in Copilot Chat with @tf-best-practices. CLI tools default to the current workspace root when no path is provided. Adding #file or #folder context can improve chat understanding, but tool execution path is controlled by explicit tool inputs (for example, path).
@tf-best-practices run run_tflint
@tf-best-practices run run_checkov
@tf-best-practices run run_trivy
@tf-best-practices run run_kics
@tf-best-practices run run_infracost
@tf-best-practices run fetch_terraform_best_practices
@tf-best-practices run run_tflint with path ./modules/network
@tf-best-practices run run_checkov with path ./environments/prod
@tf-best-practices run run_trivy with path .
@tf-best-practices run run_kics with path .
@tf-best-practices run run_infracost with path .
@tf-best-practices run fetch_terraform_best_practices with topic modules
@tf-best-practices run fetch_provider_best_practices with provider azure
@tf-best-practices run fetch_terraform_registry_guidance with provider azurerm and resource resource_group
@tf-best-practices run analyze_terraform_code with code <paste code> and focusArea modularity
@tf-best-practices run analyze_terraform_performance with terraformCode <paste code>
@tf-best-practices run analyze_state_management with terraformCode <paste code>
@tf-best-practices run generate_cost_report with infracostJson <paste json>
@tf-best-practices run generate_terraform_module_docs with terraformCode <paste code>
@tf-best-practices run recommend_terraform_modules with terraformCode <paste code> and provider azure
@tf-best-practices run suggest_terraform_architecture with workloadType web-api and environments ["dev","stage","prod"]
@tf-best-practices run suggest_terraform_testing_strategy with ciSystem github-actions
@tf-best-practices run suggest_security_hardening with scanOutput <paste output> and scanTool checkov
@tf-best-practices run generate_compliance_summary with complianceFramework cis
>=24.14.0PATH for command tools:
tflintcheckovtrivykicsinfracostIf a CLI is missing, the server returns installation guidance instead of failing silently.
Runtime:
@modelcontextprotocol/sdk (MCP server SDK)zod (input schema validation)Development:
typescript (build/compile)tsx (development runner)vitest (unit test runner)@types/node (Node.js typings)INFRACOST_API_KEY: Infracost API key for cloud-backed cost estimates.npm install
npm run build
This workspace is preconfigured in .vscode/mcp.json:
{
"servers": {
"tf-best-practices": {
"type": "stdio",
"command": "npm",
"args": ["run", "dev"]
}
}
}
Reload VS Code (Cmd+Shift+P -> Developer: Reload Window) after changing MCP configuration.
Then query the server from Copilot Chat with @tf-best-practices, for example:
@tf-best-practices run run_tflint
@tf-best-practices run fetch_terraform_best_practices with topic modules
Use stdio transport with the built entrypoint:
{
"name": "terraform-best-practices-mcp-server",
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/terraform-best-practices-mcp/dist/index.js"]
}
Build first with npm run build, then start your MCP client.
npm start
Development mode:
npm run dev
Use .vscode/launch.json:
Debug MCP Server (runs npm run dev)Debug MCP Server (Built) (runs dist/index.js after build)Set breakpoints in src/index.ts, then press F5.
See docs/TESTING.md for Copilot Chat scenarios, manual JSON-RPC checks, and troubleshooting guidance.
Quick validation prompt in Copilot Chat:
@tf-best-practices run run_tflint
@tf-best-practices run run_checkov
@tf-best-practices run suggest_security_hardening with scanOutput <paste checkov output> and scanTool checkov
@tf-best-practices run generate_compliance_summary with checkovOutput <paste output> and complianceFramework cis
@tf-best-practices run run_infracost
@tf-best-practices run generate_cost_report with infracostJson <paste json>
@tf-best-practices run analyze_terraform_code with code <paste code> and focusArea modularity
@tf-best-practices run analyze_state_management with terraformCode <paste code>
@tf-best-practices run suggest_terraform_architecture with workloadType web-api and multiRegion true
fetch_terraform_best_practices to align with community conventions.fetch_provider_best_practices for provider-specific patterns.timeoutMs high enough for large Terraform projects.suggest_terraform_testing_strategy when onboarding new CI/CD pipelines.generate_compliance_summary regularly for audit readiness.Maintained by Carl Dawson under the Down At The Bottom Of The Mole Hole organization.
npm run lint
npm test
npm run build
Licensed under the MIT License.
MCP server for Terraform cost, lint, security, and cloud best-practice guidance.
{ "mcpServers": { "downatthebottomofthemolehole-terraform-best-practices-mcp-server": { "command": "npx", "args": [ "-y", "@downatthebottomofthemolehole/[email protected]" ] } }}Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
@downatthebottomofthemolehole/terraform Best Practices chạy cục bộ qua stdio.
Kiểm tra lần cuối: 2026-11-17. MCP server for Terraform cost, lint, security, and cloud best-practice guidance.