cloudcraft-mcp
cloudcraft-mcp
Сервер Model Context Protocol (MCP) для Cloudcraft.co — позволяет просматривать, читать, экспортировать и создавать чертежи облачной архитектуры из Claude Desktop и других MCP-клиентов.
Возможности
Девять инструментов, доступных для MCP-хоста:
Инструмент | Описание |
| Возвращает профиль пользователя Cloudcraft для настроенного ключа. |
| Список всех чертежей в аккаунте. |
| Получение полного JSON-представления узлов/связей чертежа. |
| Создание нового чертежа из JSON-полезной нагрузки. |
| Замена содержимого существующего чертежа. |
| Удаление чертежа (необратимо). |
| Рендеринг чертежа в формат PNG / SVG / PDF / mxgraph на диске. |
| Список аккаунтов AWS, подключенных для снимков в реальном времени. |
| Создание снимка одного сервиса AWS в реальном времени. |
Related MCP server: AWS MCP Server
Требования
Python 3.10+
uv (
brew install uv)API-ключ Cloudcraft — создайте его на странице https://app.cloudcraft.co/ → User settings → API keys
Установка
Клонируйте репозиторий и позвольте uv разрешить зависимости при первом запуске — явный шаг установки не требуется.
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 exitИнтеграция с Claude Desktop
Отредактируйте файл ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или его эквивалент для вашей платформы:
{
"mcpServers": {
"cloudcraft": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/cloudcraft-mcp",
"run",
"cloudcraft-mcp"
],
"env": {
"CLOUDCRAFT_API_KEY": "your-key-here"
}
}
}
}Перезапустите Claude Desktop. На вкладке Developer должно появиться подключение cloudcraft.
Переменные окружения
Имя | Обязательно | По умолчанию | Назначение |
| да | — | API-ключ (Bearer). Генерируется в настройках пользователя Cloudcraft. |
| нет |
| Переопределение для прокси или будущих версий API. |
| нет |
| Уровень логирования Stderr ( |
Примеры использования (в Claude)
После подключения сервера вы можете спрашивать Claude о следующем:
"Перечисли мои чертежи Cloudcraft и кратко опиши, что представляет каждый из них."
"Экспортируй чертеж
f0086b32-...в формате PNG и сохрани его на рабочий стол."
"Возьми архитектуру, которую я только что спроектировал, и создай новый чертеж Cloudcraft под названием 'Prod 2026'."
"Сделай снимок экземпляров EC2 в регионе
ap-northeast-2для моего подключенного аккаунта AWS."
Структура полезной нагрузки чертежа
create_blueprint / update_blueprint принимают полный объект data Cloudcraft. Минимальная полезная нагрузка:
{
"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
}Обратитесь к документации API Cloudcraft для получения полного каталога типов узлов и полей, специфичных для сервисов.
Разработка
uv sync --extra dev
uv run pytest # unit tests (no network)
uv run ruff check . # lint
uv run mypy src # type checkТесты имитируют HTTP-слой с помощью respx, поэтому API-ключ не требуется.
Структура проекта
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.mdЗаметки по проектированию
Разделение транспорта и логики.
client.py— это простой асинхронный HTTP-клиент, который можно импортировать из скриптов или инструментов командной строки без использования среды выполнения MCP.server.pyотвечает только за интерфейс инструментов MCP.Авторизация через Bearer-токен. API Cloudcraft ожидает
Authorization: Bearer <key>(неApikey). Клиент устанавливает это автоматически.Никаких секретов в аргументах процесса. API-ключ считывается из
CLOUDCRAFT_API_KEY; никогда не передавайте его в командной строке.Обработка ошибок. Ответы, отличные от 2xx, вызывают
CloudcraftErrorс сохранением статуса и тела ответа, которые переупаковываются какRuntimeErrorна границе MCP, чтобы Claude мог отобразить понятное сообщение.
Безопасность
API-ключи предоставляют полный доступ на чтение/запись к вашему аккаунту Cloudcraft. Относитесь к ним как к секретным данным и регулярно обновляйте их.
delete_blueprintнеобратим — при запросе к Claude на удаление четко указывайте целевой ID.Для сценариев с интенсивным чтением создайте отдельного пользователя Cloudcraft с правами только на чтение (если/когда Cloudcraft добавит ключи с ограниченными правами) и используйте этот ключ для MCP.
Участие в разработке
Вопросы и PR приветствуются на https://github.com/hypark5540/cloudcraft-mcp. Пожалуйста, запустите ruff, mypy и pytest перед отправкой.
Лицензия
MIT — см. LICENSE.
См. также
awslabs/mcp — коллекция MCP-серверов от AWS
modelcontextprotocol/servers — эталонные реализации 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
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.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
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