io.github.cloudforgetech6-ctrl/cloudforge
Visualise diagrams, generate Terraform HCL, and manage Azure/AWS/GCP infrastructure with AI.
Open source Open in the app JSON README (API)
About
Visualise diagrams, generate Terraform HCL, and manage Azure/AWS/GCP infrastructure with AI.
Details
- Kind
- MCP servers
- Topic
- Cloud & DevOps
- Publisher
- cloudforgetech6-ctrl
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.1.0
- Last push
- 2026-08-03T23:32:13Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:35
- Updated
- 2026-08-29 03:02:35
- Origin id
io.github.cloudforgetech6-ctrl/cloudforge
README
# CloudForge MCP Server
[](https://www.npmjs.com/package/cloudforge-mcp)
[](LICENSE)
MCP server for [CloudForge](https://cloudforge.cloud) — 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 |
### Mold Library
| Tool | Description |
|------|-------------|
| `cloudforge_list_molds` | Browse 90 curated architecture templates (30 per cloud) — filter by provider, category, or search |
| `cloudforge_get_mold` | Full detail for one Mold: layout, "why this shape" best practices, inline Mermaid preview, forge link |
### 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_org_details` | Organisation overview: name, plan, member count, MFA policy, custom assistant name |
| `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 |
### Pricing
| Tool | Description |
|------|-------------|
| `cloudforge_get_pricing` | Get CloudForge's current plans & pricing (Free, Pro, Team, Business), incl. the 14-day free trial — fetched live |
## Setup
### Claude Desktop (recommended)
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"cloudforge": {
"command": "npx",
"args": ["-y", "cloudforge-mcp"],
"env": {
"CLOUDFORGE_TOKEN": "your-bearer-token"
}
}
}
}
```
### Claude Code / `.mcp.json`
```json
{
"mcpServers": {
"cloudforge": {
"command": "npx",
"args": ["-y", "cloudforge-mcp"],
"env": {
"CLOUDFORGE_TOKEN": "your-bearer-token"
}
}
}
}
```
## Authentication
1. Sign in at [cloudforge.cloud](https://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
```
```
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 john@example.com as a Member to my organisation
```
## Pricing
The `cloudforge_get_pricing` tool returns CloudForge's current plans live (so they're always up to date). All prices USD; paid plans include a **14-day free trial**:
| Plan | Price |
|---|---|
| **Free** | $0 — visual designer, limited export, community support |
| **Pro** | **US$9.99/mo** or US$99/yr · 14-day free trial |
| **Team** | **US$12/user/mo** (3-seat min) · 14-day free trial |
| **Business** | Contact us — volume/annual pricing |
Full details: [cloudforge.cloud/pricing](https://cloudforge.cloud/pricing).
## Self-hosting
If you run CloudForge on-premises, point the server at your own API:
```json
"env": {
"CLOUDFORGE_API_URL": "https://your-cloudforge-host/api",
"CLOUDFORGE_TOKEN": "your-token"
}
```
## License
MIT © [CloudForge](https://cloudforge.cloud)