mcp_server

CloudForge MCP Server

 

MCP server for CloudForge — lets Claude and other AI assistants visualise cloud architecture diagrams, generate Terraform HCL, import existing IaC, and manage your infrastructure resources directly from chat.

Tools

Visualisation

| Tool | Description | |------|-------------| | cloudforge_diagram_to_mermaid | Fetch a saved diagram and render it as an inline Mermaid flowchart | | cloudforge_architecture_summary | Structured summary: resource counts by category, central components, inline diagram | | cloudforge_mermaid_from_json | Convert raw diagram JSON to Mermaid without fetching from the server |

Terraform

| Tool | Description | |------|-------------| | cloudforge_generate_terraform | Generate Terraform HCL from a natural-language architecture description | | cloudforge_export_terraform_from_diagram | Export Terraform HCL from an existing saved diagram in one step | | cloudforge_import_terraform | Parse existing HCL → diagram structure + Mermaid preview |

AI Architect

| Tool | Description | |------|-------------| | cloudforge_chat | Ask the CloudForge AI Architect for IaC advice, cost estimates, security reviews | | cloudforge_suggest_resources | Get AI-recommended resources and connections for a described use case |

Diagram Management

| Tool | Description | |------|-------------| | cloudforge_list_diagrams | List saved diagrams with metadata | | cloudforge_recent_diagrams | Get recently accessed/modified diagrams | | cloudforge_get_diagram | Fetch a diagram by ID (full JSON) | | cloudforge_save_diagram | Save or update a diagram | | cloudforge_delete_diagram | Permanently delete a diagram |

Organisation

| Tool | Description | |------|-------------| | cloudforge_list_members | List organisation members (name, email, role, status) | | cloudforge_invite_member | Send an organisation invitation | | cloudforge_list_invitations | List pending invitations | | cloudforge_cancel_invitation | Cancel a pending invitation | | cloudforge_remove_member | Remove a member from the organisation |

Setup

Claude Desktop (recommended)

Add to your 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"
      }
    }
  }
}

Authentication

1. Sign in at cloudforge.cloud
2. Go to Account → API Keys
3. Click Generate API Key, give it a name (e.g. CloudForge MCP), and copy the key — it starts with cf_live_ and is shown only once
4. Set it as CLOUDFORGE_TOKEN in your MCP config

The key is long-lived and can be revoked from the same page at any time.

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | CLOUDFORGE_TOKEN | _(required)_ | CloudForge API key — must start with cf_live_ | | CLOUDFORGE_API_URL | https://cloudforge.cloud/api | API base URL — only change if self-hosting |

Example prompts

Show me my recent diagrams

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 john@example.com as a Member to my organisation

Self-hosting

If you run CloudForge on-premises, point the server at your own API:

"env": {
  "CLOUDFORGE_API_URL": "https://your-cloudforge-host/api",
  "CLOUDFORGE_TOKEN": "your-token"
}

License

MIT © CloudForge