CloudForge MCP 服务

适用于 CloudForge 的 MCP 服务,可让 Claude 和其他 AI 助手通过聊天可视化云架构图、生成 Terraform HCL、导入现有 IaC,并管理基础设施资源。
工具
可视化
| 工具 | 描述 |
|---|
cloudforge_diagram_to_mermaid | 获取已保存的图表,并将其渲染为内嵌 Mermaid 流程图 |
cloudforge_architecture_summary | 结构化摘要:按类别统计资源、列出核心组件,并提供内嵌图表 |
cloudforge_mermaid_from_json | 将原始图表 JSON 转换为 Mermaid,无需从服务端获取 |
Terraform
| 工具 | 描述 |
|---|
cloudforge_generate_terraform | 根据自然语言架构描述生成 Terraform HCL |
cloudforge_export_terraform_from_diagram | 一步从现有的已保存图表导出 Terraform HCL |
cloudforge_parse_terraform | 将原始 HCL 转换为图表结构——结果确定、无需 AI,也无需账号 |
cloudforge_export_terraform | 按当前状态导出已保存图表的 Terraform,不重新生成 |
cloudforge_import_terraform | 解析现有 HCL → 图表结构 + Mermaid 预览 |
AI 架构师
| 工具 | 描述 |
|---|
cloudforge_chat | 向 CloudForge AI 架构师咨询 IaC 建议、成本估算和安全审查 |
cloudforge_suggest_resources | 获取 AI 针对所描述用例推荐的资源和连接 |
模板库
| 工具 | 描述 |
|---|
cloudforge_list_molds | 浏览 90 个精选架构模板(每个云平台 30 个)——可按提供商、类别或搜索词筛选 |
cloudforge_get_mold | 获取一个 Mold 的完整详情:布局、“为何采用这种形态”的最佳实践、内嵌 Mermaid 预览和 forge 链接 |
图表管理
| 工具 | 描述 |
|---|
cloudforge_list_diagrams | 列出已保存的图表及其元数据 |
cloudforge_recent_diagrams | 获取最近访问或修改的图表 |
cloudforge_get_diagram | 按 ID 获取图表(完整 JSON) |
cloudforge_save_diagram | 保存或更新图表 |
cloudforge_delete_diagram | 永久删除图表 |
组织管理
| 工具 | 描述 |
|---|
cloudforge_org_details | 组织概览:名称、套餐、成员数量、多重身份验证(MFA)策略、自定义助手名称 |
cloudforge_list_members | 列出组织成员(姓名、电子邮件、角色、状态) |
cloudforge_invite_member | 发送组织邀请 |
cloudforge_list_invitations | 列出待处理的邀请 |
cloudforge_cancel_invitation | 取消待处理的邀请 |
cloudforge_remove_member | 从组织中移除成员 |
定价
| 工具 | 描述 |
|---|
cloudforge_get_pricing | 获取 CloudForge 当前的套餐和定价(Free、Pro、Team、Business),包括 14 天免费试用信息——实时获取 |
部署
实际的基础设施变更。apply 和 destroy 会停在人工审批关卡;在调用 cloudforge_approve_deployment 之前不会更改任何内容,因此 Agent 无法自行部署。
| 工具 | 描述 |
|---|
cloudforge_plan | 运行 terraform plan——显示添加/更改/销毁差异及安全质量关卡。只读 |
cloudforge_dry_run | 验证并制定计划,不触及云账户 |
cloudforge_validate_deployment | 提供商和 HCL 部署前检查 |
cloudforge_apply | 开始实际部署。会创建资源并产生费用;会停在审批关卡 |
cloudforge_destroy | 开始销毁操作。会永久删除基础设施;同样需要通过审批关卡 |
cloudforge_approve_deployment | 批准或拒绝等待审批的作业——这一步才会实际更改云环境 |
cloudforge_deployment_status | 单个作业的状态和日志 |
cloudforge_deployment_history | 针对某个图表运行过的所有部署 |
质量与成本
| 工具 | 描述 |
|---|
cloudforge_fix_terraform | 根据错误日志修复损坏的 HCL——部署管道用于修复自身的同一款修复工具 |
cloudforge_validate_terraform | 不进行部署,检查语法和提供商架构 |
cloudforge_estimate_cost | 按资源估算每月成本 |
cloudforge_review_architecture | AI 评审:可靠性、安全性、成本和扩展方面的权衡 |
漂移与合规
| 工具 | 描述 |
|---|
cloudforge_scan_drift | 将图表与实际部署的内容进行比较 |
cloudforge_latest_drift | 某个图表最近的漂移报告 |
cloudforge_drift_report | 按 ID 读取某份漂移报告——扫描后轮询此项 |
cloudforge_compliance_frameworks | 可供扫描的框架(APRA CPS 234、CIS 等) |
cloudforge_compliance_scan | 根据框架进行扫描——提供确定性证据和控制项映射,绝非 AI 意见 |
自我修复——检测、批准、修复
始终按此顺序执行三个步骤。我们有意不提供批准修复的工具:批准意味着有人阅读了将要发生的变更并表示同意;若有工具可以代表他们授予这种同意,就会抹去此功能所能提供的唯一保障。可以自由检测并报告;由用户在 CloudForge 面板、VS Code 扩展或 JetBrains 工具窗口中批准;然后再进行修复。
| 工具 | 描述 |
|---|
cloudforge_detect_remediations | 将已完成的漂移报告转化为拟议修复,等待人工决策 |
cloudforge_list_remediations | 查看提案及其各自的状态 |
cloudforge_heal_approved | 仅应用人工批准的内容;在 Terraform 计划处暂停,等待再次确认 |
cloudforge_remediation_ledger | 仅追加的审计记录:更改了什么、原因是什么,以及谁批准了更改 |
cloudforge_remediation_policy | 修复工作的边界——排除的资源类型,以及提案可执行的时限 |
治理
| 工具 | 描述 |
|---|
cloudforge_list_policies | 为组织配置的治理策略 |
cloudforge_evaluate_policies | 部署前根据策略检查设计——管道也会强制执行相同的规则 |
协作
| 工具 | 描述 |
|---|
cloudforge_foundry_diagrams | 组织内共享的图表(The Foundry) |
cloudforge_list_templates | 由组织编写的模板,与内置 Molds 不同 |
设置
Claude Desktop(推荐)
将以下内容添加到 claude_desktop_config.json:
{
"mcpServers": {
"cloudforge": {
"command": "npx",
"args": ["-y", "cloudforge-mcp"],
"env": {
"CLOUDFORGE_TOKEN": "your-bearer-token"
}
}
}
}
Claude Code / .mcp.json
{
"mcpServers": {
"cloudforge": {
"command": "npx",
"args": ["-y", "cloudforge-mcp"],
"env": {
"CLOUDFORGE_TOKEN": "your-bearer-token"
}
}
}
}
身份验证
- 在 cloudforge.cloud 登录
- 前往 账户 → API 密钥
- 点击 生成 API 密钥,为其命名(例如
CloudForge MCP),然后复制密钥——密钥以 cf_live_ 开头,且只会显示一次
- 在 MCP 配置中将其设为
CLOUDFORGE_TOKEN
此密钥长期有效,可随时在同一页面撤销。
环境变量
| 变量 | 默认值 | 描述 |
|---|
CLOUDFORGE_TOKEN | (必填) | CloudForge API 密钥——必须以 cf_live_ 开头 |
CLOUDFORGE_API_URL | https://cloudforge.cloud/api | API 基础 URL——仅在自托管时更改 |
示例提示词
Show me my recent diagrams
What serverless Molds do you have for AWS?
Show me the azure-3-tier-web-app Mold and explain why it's shaped that way
Render diagram <id> as a Mermaid chart
Generate Terraform for a 3-tier Azure web app with a private SQL database in UK South
Import this Terraform and show me a diagram: <paste HCL>
What are the security best practices for the resources in diagram <id>?
Invite [email protected] as a Member to my organisation
定价
cloudforge_get_pricing 工具会实时返回 CloudForge 当前的套餐信息(因此始终是最新信息)。所有价格均以美元计;付费套餐包含 14 天免费试用:
| 套餐 | 价格 |
|---|
| Free | $0 — 可视化设计器、有限的导出功能、社区支持 |
| Pro | US$9.99/月 或 US$99/年 · 14 天免费试用 |
| Team | US$12/用户/月(至少 3 个席位)· 14 天免费试用 |
| Business | 联系我们——批量/年度定价 |
详情请见:cloudforge.cloud/pricing。
自托管
如果你在本地部署 CloudForge,请将服务指向你自己的 API:
"env": {
"CLOUDFORGE_API_URL": "https://your-cloudforge-host/api",
"CLOUDFORGE_TOKEN": "your-token"
}
许可证
MIT © CloudForge