@cloud-arch/mcp-server

MCP server for creating interactive architecture diagrams on CloudArch.

Works with Claude Desktop, Claude Code, and any MCP-compatible client.

Quick Start

1. Get an API key

1. Sign in at web.cloud-arch.ru
2. Go to Dashboard > API Keys
3. Create a key and copy it

2. Configure your MCP client

Add to your MCP config (.mcp.json for Claude Code, or Claude Desktop settings):

{
  "mcpServers": {
    "cloudarch": {
      "command": "npx",
      "args": ["-y", "@cloud-arch/mcp-server"],
      "env": {
        "CLOUDARCH_API_KEY": "ca_your_key_here"
      }
    }
  }
}

Or install globally:

npm install -g @cloud-arch/mcp-server

Then use cloudarch-mcp as the command instead of npx.

Catalogs

The package ships a server.json for the MCP Registry (server name io.github.lamp-labs/cloudarch) and a smithery.yaml that describes a hosted build for Smithery. Both point at this same npm package; nothing changes at runtime.

3. Use

Ask Claude:

"Create an architecture diagram for a microservices e-commerce platform with API Gateway, Auth, Orders, Payments, PostgreSQL, Redis cache, and Kafka"

The MCP server will generate a topology script, save it via the CloudArch API, and return a live URL with an interactive animated diagram.

Available Tools

| Tool | Description | |------|-------------| | create_diagram | Create a new diagram from a natural language description or custom script code | | update_diagram | Update an existing diagram by ID or slug | | delete_diagram | Delete a diagram by ID | | list_diagrams | List your existing diagrams | | get_script_template | Get the script writing guide/template for generating diagrams |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | CLOUDARCH_API_KEY | Yes | - | API key from your CloudArch dashboard | | CLOUDARCH_API_URL | No | https://api.cloud-arch.ru | HTTPS API base URL for self-hosted instances; plain HTTP is accepted only for localhost, 127.0.0.1, or ::1 development |

License

MIT