cloudcraft-mcp
cloudcraft-mcp
Servidor del Protocolo de Contexto de Modelo (MCP) para Cloudcraft.co: permite listar, leer, exportar y crear planos de arquitectura en la nube desde Claude Desktop y otros clientes MCP.
Características
Nueve herramientas expuestas al host MCP:
Herramienta | Descripción |
| Devuelve el perfil de usuario de Cloudcraft para la clave configurada. |
| Lista todos los planos de la cuenta. |
| Obtiene el JSON completo de nodos/bordes de un plano. |
| Crea un nuevo plano a partir de una carga útil JSON. |
| Reemplaza la carga útil de un plano existente. |
| Elimina un plano (irreversible). |
| Renderiza un plano a PNG / SVG / PDF / mxgraph en el disco. |
| Lista las cuentas de AWS conectadas para instantáneas de escaneo en vivo. |
| Realiza una instantánea de escaneo en vivo de un servicio de AWS. |
Related MCP server: AWS MCP Server
Requisitos
Python 3.10+
uv (
brew install uv)Clave de API de Cloudcraft: genere una en https://app.cloudcraft.co/ → User settings → API keys
Instalación
Clone el repositorio y deje que uv resuelva las dependencias en la primera ejecución; no se requiere un paso de instalación explícito.
git clone https://github.com/hypark5540/cloudcraft-mcp.git
cd cloudcraft-mcp
export CLOUDCRAFT_API_KEY='your-key-here'
uv run cloudcraft-mcp # smoke test — Ctrl+C to exitIntegración con Claude Desktop
Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o el equivalente en su plataforma:
{
"mcpServers": {
"cloudcraft": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/cloudcraft-mcp",
"run",
"cloudcraft-mcp"
],
"env": {
"CLOUDCRAFT_API_KEY": "your-key-here"
}
}
}
}Reinicie Claude Desktop. La pestaña Developer debería mostrar cloudcraft como conectado.
Variables de entorno
Nombre | Requerido | Predeterminado | Propósito |
| sí | — | Clave de API (Bearer). Generada en la configuración de usuario de Cloudcraft. |
| no |
| Sustitución para proxies o futuras versiones de la API. |
| no |
| Verbosidad del registro en Stderr ( |
Ejemplos de uso (en Claude)
Una vez que el servidor esté conectado, pregunte a Claude cosas como:
"Lista mis planos de Cloudcraft y resume lo que representa cada uno."
"Exporta el plano
f0086b32-...como PNG y guárdalo en mi escritorio."
"Toma la arquitectura que acabo de diseñar y crea un nuevo plano de Cloudcraft llamado 'Prod 2026'."
"Realiza una instantánea de las instancias EC2 en
ap-northeast-2para mi cuenta de AWS conectada."
Forma de la carga útil del plano
create_blueprint / update_blueprint aceptan el objeto data completo de Cloudcraft. Una carga útil mínima:
{
"grid": "infinite",
"projection": "isometric",
"theme": {"base": "light"},
"version": 6,
"nodes": [
{"id": "...", "type": "ec2", "mapPos": [3, 3], "region": "ap-northeast-2",
"instanceType": "m7g", "instanceSize": "large", "platform": "linux"},
{"id": "...", "type": "s3", "mapPos": [1, 8], "region": "ap-northeast-2",
"volumeType": "Standard", "dataGb": 100}
],
"edges": [
{"from": "...ec2-id...", "to": "...s3-id...", "type": "edge",
"width": 2, "dashed": false, "endCap": "arrow"}
],
"groups": [], "surfaces": [], "text": [], "icons": [],
"connectors": [], "images": [], "disabledLayers": [],
"shareDocs": false
}Consulte la documentación de la API de Cloudcraft para ver el catálogo completo de tipos de nodos y campos específicos del servicio.
Desarrollo
uv sync --extra dev
uv run pytest # unit tests (no network)
uv run ruff check . # lint
uv run mypy src # type checkLas pruebas simulan la capa HTTP con respx, por lo que no se requiere una clave de API.
Estructura del proyecto
cloudcraft-mcp/
├── src/cloudcraft_mcp/
│ ├── __init__.py
│ ├── __main__.py # python -m cloudcraft_mcp
│ ├── server.py # MCP tool definitions (FastMCP)
│ ├── client.py # CloudcraftClient — async httpx wrapper
│ ├── types.py # TypedDicts for blueprint payloads
│ └── py.typed
├── tests/
│ └── test_client.py
├── server.py # back-compat shim -> cloudcraft_mcp.server:main
├── pyproject.toml
├── LICENSE
└── README.mdNotas de diseño
División de transporte/lógica.
client.pyes un cliente HTTP asíncrono simple que puede importar desde scripts o herramientas CLI sin necesidad de cargar el tiempo de ejecución de MCP.server.pysolo gestiona la superficie de herramientas de MCP.Autenticación con token Bearer. La API de Cloudcraft espera
Authorization: Bearer <key>(noApikey). El cliente lo configura automáticamente.Sin secretos en los argumentos del proceso. La clave de API se lee desde
CLOUDCRAFT_API_KEY; nunca la pase por la línea de comandos.Superficie de error. Las respuestas que no son 2xx generan un
CloudcraftErrorcon el estado y el cuerpo preservados, reempaquetados comoRuntimeErroren el límite de MCP para que Claude vea un mensaje legible.
Seguridad
Las claves de API otorgan acceso total de lectura/escritura a su cuenta de Cloudcraft. Trátelas como secretos y rótelas regularmente.
delete_blueprintes irreversible; al pedirle a Claude que elimine algo, sea explícito sobre el ID de destino.Para configuraciones con mucha lectura, cree un usuario de Cloudcraft dedicado con alcance de solo lectura (si Cloudcraft añade claves con alcance) y use esa clave para MCP.
Contribución
Las incidencias y PR son bienvenidas en https://github.com/hypark5540/cloudcraft-mcp. Por favor, ejecute ruff, mypy y pytest antes de enviar.
Licencia
MIT: consulte LICENSE.
Relacionado
awslabs/mcp: colección de servidores MCP de AWS
modelcontextprotocol/servers: implementaciones de referencia de servidores MCP
Available Tools
13 toolscreate_blueprintB
Create a new Cloudcraft blueprint.
Args: name: Display name for the new blueprint. data: Full blueprint payload (nodes, edges, groups, surfaces, text, icons, connectors, theme, projection, etc.). See README for a minimal example.
Returns the created blueprint metadata including the assigned id.
Inputs: data (required), name (required). Returns: object
delete_blueprintADestructive
Delete a Cloudcraft blueprint after exact-id confirmation.
Args: blueprint_id: Blueprint UUID. confirm_blueprint_id: Repeat the exact UUID to acknowledge the irreversible operation.
Inputs: blueprint_id (required), confirm_blueprint_id (required). Returns: object
export_blueprint_budgetADestructive
Export a blueprint's cost estimate (budget) to a CSV or XLSX file on disk.
Same write sandbox as :func:export_blueprint_image.
Args:
blueprint_id: Blueprint UUID.
format: csv or xlsx. Default csv.
output_path: Absolute path under the export directory. Default:
<export_dir>/cloudcraft_<uuid>_budget.<ext>.
currency: ISO 4217 code — USD (default), AUD, CHF, EUR,
GBP, HKD, JPY, NOK, NZD, SEK, ZAR.
period: h hourly, d daily, w weekly, m monthly
(default), y yearly.
rate: effective (default, includes upfront fees) or stated.
overwrite: Set True to replace an existing file.
Returns:
{"path": <saved_path>, "bytes": <size>, "format": <fmt>}
Inputs: blueprint_id (required), rate, format, period, +3 more. Returns: object
export_blueprint_imageADestructive
Render a Cloudcraft blueprint to an image file on disk.
Writes are restricted to CLOUDCRAFT_EXPORT_DIR (default: system temp
directory). Set CLOUDCRAFT_EXPORT_DIR=/path/to/dir in the MCP server
environment to allow saving under a different directory.
Args:
blueprint_id: Blueprint UUID.
format: One of png, svg, pdf, mxgraph. Default png.
output_path: Absolute path to save to, must resolve under the export
directory. Default: <export_dir>/cloudcraft_<uuid>.<ext>.
scale: Optional PNG render scale (e.g. 1.0, 2.0). PNG only.
transparent: PNG transparent background (bool). PNG only.
overwrite: Set True to replace an existing file at output_path.
Default False — existing files are preserved.
Returns:
{"path": <saved_path>, "bytes": <size>, "format": <fmt>}
Inputs: blueprint_id (required), scale, format, overwrite, +2 more. Returns: object
get_blueprintARead-only
Fetch the full blueprint payload (nodes, edges, groups, layout).
Args:
blueprint_id: Blueprint UUID from :func:list_blueprints.
Inputs: blueprint_id (required). Returns: object
list_aws_accountsARead-only
List AWS accounts registered with Cloudcraft for live-scan snapshots.
Inputs: no named parameters. Returns: object
list_azure_accountsARead-only
List Azure accounts registered with Cloudcraft for live-scan snapshots.
Inputs: no named parameters. Returns: object
list_blueprintsARead-only
List every Cloudcraft blueprint (diagram) in the authenticated account.
Returns a compact summary per blueprint (id, name, tags, updatedAt).
Use :func:get_blueprint afterwards to pull the full node / edge JSON.
Inputs: no named parameters. Returns: object
list_teamsBRead-only
List the teams linked to the Cloudcraft account (id, name, members).
Inputs: no named parameters. Returns: object
snapshot_awsBIdempotent
Scan one AWS region into a blueprint JSON via Cloudcraft live-scan.
Inputs: region (required), account_id (required), filter, exclude. Returns: object
snapshot_azureCIdempotent
Scan one Azure region into a blueprint JSON via Cloudcraft live-scan.
Inputs: region (required), account_id (required), filter, exclude. Returns: object
update_blueprintADestructiveIdempotent
Replace the full data payload of an existing blueprint.
Args:
blueprint_id: Blueprint UUID.
data: Full blueprint payload (same shape as :func:create_blueprint).
Inputs: data (required), blueprint_id (required). Returns: object
whoamiARead-only
Return the Cloudcraft user profile for the current API key.
Useful as a sanity check after configuring a new key.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool maps to a distinct resource/action pair: team/profile read, blueprint CRUD, two clearly separated export formats (image vs budget), and account listing vs region snapshots. The only near-overlap, export_blueprint_image vs export_blueprint_budget, is made unambiguous by explicit format and output descriptions.
Almost everything follows a clean verb_noun snake_case pattern (list_*, get_*, create_*, update_*, delete_*, export_*, snapshot_*). The lone deviation is `whoami`, which breaks the pattern but is idiomatic and unambiguous.
13 tools is well within the ideal 3-15 range and each earns its place: 5 blueprint CRUD tools, 2 exports, 2 account listers, 2 snapshotters, plus team/profile reads. No filler tools.
Blueprint lifecycle is fully covered (list/get/create/update/delete plus image and budget export), and both AWS and Azure snapshot paths exist. Minor gaps: no account-level get/registration tools, no team management, and update_blueprint replaces the whole payload so rename/metadata edits are awkward — all workaroundable.
Maintenance
Related MCP Connectors
Connect Claude or any MCP client to Wireflow, the AI canvas for image, video and audio workflows. List, build, inspect and run your workflows and published apps, browse templates, check models, prices and credits, edit a video node's timeline, and plan or schedule social posts. Drafts and edits cost no credits; run tools spend the user's credits.
AI Visibility and Content Intelligence tools for Claude and MCP-compatible agents.
Connect Amazon Seller Central to Claude or ChatGPT via MCP. Orders, inventory, pricing, fees, FBA.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables Claude to interact with core AWS services like S3, EC2, RDS, and CloudWatch, along with a generic SDK wrapper for any AWS operation. It also supports cost monitoring and optional vector store capabilities for document ingestion and search.103-
- AlicenseBqualityDmaintenanceEnables Claude Desktop to interact with 57 AWS services using over 200 tools and local machine profiles. It supports multi-profile configurations and features a read-only safe mode by default to manage infrastructure like EC2, S3, and Lambda securely.100BSD 3-Clause
- AlicenseAqualityDmaintenanceEnables browsing S3 buckets and objects, and generating secure presigned URLs for downloads and uploads, through natural language commands in MCP clients like Claude Desktop.34MIT
- AlicenseNot gradedqualityDmaintenanceEnables natural language control of AWS resources (EC2, Security Groups, S3, Bedrock, etc.) directly from Claude Desktop or Claude Code.75 PyPIMIT