Skip to content
MCP server

Cloudcraft MCP

Unofficial server to list, export and build Cloudcraft cloud architecture blueprints

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.1.8
Listing updated
today

Similar MCP servers

About Cloudcraft MCP

Cloudcraft MCP is a free MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

This community-built server wraps the Cloudcraft API so an assistant can work with cloud architecture diagrams. It is unofficial, uses a Cloudcraft API key from the user settings page, and exposes 13 tools: whoami, list_blueprints, get_blueprint, create_blueprint, update_blueprint, delete_blueprint, export_blueprint_image, export_blueprint_budget, list_teams, list_aws_accounts, snapshot_aws, list_azure_accounts and snapshot_azure.

It is read-only by default. Creating or updating blueprints needs CLOUDCRAFT_ENABLE_WRITES=true, and deletes additionally need CLOUDCRAFT_ENABLE_DELETES=true. Exports of images (PNG, SVG, PDF, mxgraph) and budget sheets (CSV or XLSX) are written only under a configured export directory, and responses above a size cap (about 25 MB by default) are rejected. snapshot_aws and snapshot_azure live-scan one region of a connected cloud account into blueprint JSON, with optional filter and exclude settings.

It installs as a pinned PyPI package through uvx or pipx, an npm launcher that still needs uv, a GHCR container image, or a Claude Desktop bundle.

Install

Run in a terminal

claude mcp add cloudcraft-mcp --env CLOUDCRAFT_API_KEY='<CLOUDCRAFT_API_KEY>' -- npx -y @hypark5540/cloudcraft-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cloudcraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hypark5540/cloudcraft-mcp"
      ],
      "env": {
        "CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cloudcraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hypark5540/cloudcraft-mcp"
      ],
      "env": {
        "CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "cloudcraft-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hypark5540/cloudcraft-mcp"
      ],
      "env": {
        "CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cloudcraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hypark5540/cloudcraft-mcp"
      ],
      "env": {
        "CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "cloudcraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hypark5540/cloudcraft-mcp"
      ],
      "env": {
        "CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CLOUDCRAFT_API_KEYCloudcraft API key with access to the target accountRequired
  • CLOUDCRAFT_BASE_URLCloudcraft API base URL; HTTPS is required except for loopback testing
  • CLOUDCRAFT_LOG_LEVELMinimum log level written to stderr
  • CLOUDCRAFT_EXPORT_DIRDirectory under which exported blueprint files may be written
  • CLOUDCRAFT_ENABLE_WRITESEnable create and update operations
  • CLOUDCRAFT_ENABLE_DELETESEnable irreversible deletes; writes must also be enabled
  • CLOUDCRAFT_MAX_RESPONSE_BYTESMaximum bytes accepted from one Cloudcraft API response
  • CLOUDCRAFT_API_KEYCloudcraft API key with access to the target accountRequired
  • CLOUDCRAFT_BASE_URLCloudcraft API base URL; HTTPS is required except for loopback testing
  • CLOUDCRAFT_LOG_LEVELMinimum log level written to stderr
  • CLOUDCRAFT_EXPORT_DIRDirectory under which exported blueprint files may be written
  • CLOUDCRAFT_ENABLE_WRITESEnable create and update operations
  • CLOUDCRAFT_ENABLE_DELETESEnable irreversible deletes; writes must also be enabled
  • CLOUDCRAFT_MAX_RESPONSE_BYTESMaximum bytes accepted from one Cloudcraft API response
  • CLOUDCRAFT_API_KEYCloudcraft API key with access to the target accountRequired
  • CLOUDCRAFT_BASE_URLCloudcraft API base URL; HTTPS is required except for loopback testing
  • CLOUDCRAFT_LOG_LEVELMinimum log level written to stderr
  • CLOUDCRAFT_EXPORT_DIRDirectory under which exported blueprint files may be written
  • CLOUDCRAFT_ENABLE_WRITESEnable create and update operations
  • CLOUDCRAFT_ENABLE_DELETESEnable irreversible deletes; writes must also be enabled
  • CLOUDCRAFT_MAX_RESPONSE_BYTESMaximum bytes accepted from one Cloudcraft API response

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

whoami
Return the Cloudcraft user profile for the configured key
list_blueprints
List every blueprint in the account
get_blueprint
Fetch a blueprint's node and edge JSON
create_blueprint
Create a blueprint from a JSON payload
update_blueprint
Replace an existing blueprint's payload
delete_blueprint
Delete a blueprint irreversibly
export_blueprint_image
Render a blueprint to PNG, SVG, PDF or mxgraph
export_blueprint_budget
Export a blueprint's cost estimate as CSV or XLSX
list_teams
List teams linked to the account
list_aws_accounts
List AWS accounts connected for snapshots
snapshot_aws
Live-scan one AWS region into blueprint JSON
list_azure_accounts
List Azure accounts connected for snapshots
snapshot_azure
Live-scan one Azure region into blueprint JSON

What it does

Blueprint CRUD
List, fetch, create, update and delete blueprints via their JSON.
Image export
Render blueprints to PNG, SVG, PDF or mxgraph on disk.
Budget export
Save cost estimates as CSV or XLSX.
AWS and Azure snapshots
Live-scan a single region into blueprint JSON.
Safe defaults
Writes and deletes are off unless enabled by environment variables.
Several install paths
PyPI, npm, Docker and a Claude Desktop bundle.

Good for

  • Summarise every Cloudcraft blueprint in an account
  • Export an architecture diagram as PNG to your desktop
  • Snapshot an AWS region and exclude security groups
  • Create a blueprint from an architecture an assistant drafted

Pricing

Free

Free server; requires a Cloudcraft API key and account

Cloudcraft MCP FAQ

Is it official?

No. The README calls it an unofficial MCP server for Cloudcraft.

What do I need to run it?

A Cloudcraft API key, plus uv; Node.js 22 or later only for the npm launcher.

Can it delete my blueprints?

Only if both writes and deletes are enabled through environment variables; both are off by default.

Which accounts can it scan?

Connected AWS and Azure accounts, one region per snapshot.

Is Cloudcraft MCP free?

Yes. Cloudcraft MCP is free to use.

How do I add Cloudcraft MCP to Claude Code?

Run this command in your terminal: claude mcp add cloudcraft-mcp --env CLOUDCRAFT_API_KEY='<CLOUDCRAFT_API_KEY>' -- npx -y @hypark5540/cloudcraft-mcp

What are the best alternatives to Cloudcraft MCP?

The closest alternatives to Cloudcraft MCP are mcp, Webflow, Ripe Stat, Vercel MCP and OpenWrt MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers