用途:分析基础设施即代码(IaC)项目,估算云成本、识别节省机会,并标记 FinOps 策略与标签策略违规。支持 Terraform、CloudFormation、Terragrunt;暂不直接支持 CDK。
主要能力:插件加载时自动启动 Infracost MCP 服务,所有操作均为 MCP 工具调用,无需运行 shell 命令或解析 JSON。scan(path="/abs/path/to/repo") 返回货币字段与摘要块,包括项目数、资源数与成本、月度费用、按策略与域统计的失败数、诊断计数及逐项目细分。摘要不返回逐资源明细,需用 inspect_* 工具下钻,扫描结果按绝对路径缓存在 MCP 会话中。可选 currency 参数(ISO 4217 代码,默认取组织配置)。
下钻工具:inspect_failing 查看失败策略、触发护栏与超预算项;inspect_top_savings 按月度节省排序取前 N;inspect_resources 按缺失标签、无效标签、成本区间等谓词筛选,或用 group_by 聚合(维度含 type、provider、project、file、resource、policy、budget、guardrail);inspect_diagnostics 查看项目诊断;inspect_policy_detail 查看单个策略的失败资源与 file:line;inspect_budget_detail 查看某预算匹配资源与节省;inspect_guardrail_detail 查看护栏状态与月度成本。policy、guardrail、budget 在 group_by 中两两互斥;guardrail 与 budget 不能与资源上下文维度组合;policy 可与资源上下文维度组合。
使用前提:运行扫描前需确认已安装 Infracost CLI、用户已认证并已选择组织。若工具返回“无扫描结果”或“未选择组织”,应把错误反馈给用户,不要盲目重试。
典型场景:策略排查(从摘要到策略再到具体资源)、护栏触发排查、预算超支排查、用 git worktree 建并行检出并对比两条分支的扫描摘要。
限制与注意:预算成本来自云账单的全组织实际支出,并非由 IaC 扫描计算,也不受当前变更影响,不应描述为“估算”或归因于本次改动;节省金额为 IaC 估算,不保证直接降低账单。基于用量的成本使用典型默认值,缺少实际用量数据,需说明不确定性。不要提交认证令牌或环境变量值;除用户明确要求外不要修改 CLI 源码;不要影响目标仓库 git 状态,扫描为只读非破坏性;对比完成后清理临时 worktree。成本货币默认由组织配置决定。