
Cloudcraft MCP
io.github.hypark5540由 GitHub 账号 hypark5540 发布v0.1.8更新于 Oct 26, 2026
Unofficial MCP server for reading and managing Cloudcraft architecture blueprints
概览
Cloudcraft 的非官方 MCP 服务器,让助手列出、读取、导出、创建、更新和删除云架构蓝图。
- 可以做什么
- 查看当前密钥对应的 Cloudcraft 用户资料
- 列出、读取和查看蓝图、团队以及已连接的 AWS 与 Azure 账户
- 用完整 JSON 载荷创建、替换或删除蓝图
- 将蓝图导出为 PNG、SVG、PDF 或 mxgraph 图片,将成本估算导出为 CSV 或 XLSX
- 实时扫描某个 AWS 或 Azure 区域并生成蓝图 JSON,可选过滤与排除
- 适用场景
- 适合在 Cloudcraft 中维护云架构图的场景:让助手总结现有蓝图、导出架构图或预算估算、根据设计生成新蓝图,或对已连接的云账户区域做快照。
- 运行要求
- 通过 uvx、pipx、npx、Docker 或 Claude Desktop 安装包在本地以 stdio 运行;npm 启动方式需要 Node.js 22+ 和 uv。需要 Cloudcraft API 密钥(环境变量 CLOUDCRAFT_API_KEY)以及访问 Cloudcraft API 的网络;可选变量可设置基础 URL、导出目录、日志级别、响应大小上限和写入/删除开关。
安装
在 SourceWeft 中
- 打开 控制台中的 Cloudcraft MCP,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
cloudcraft-mcp
[CI] [codecov] [PyPI] [npm] [License: MIT] [Python 3.10+]
Unofficial Model Context Protocol (MCP) server for Cloudcraft — list, read, export, and build cloud architecture blueprints from Claude Desktop and other MCP clients.
Features
Thirteen tools exposed to the MCP host:
Requirements
- uv for the
recommended
uvxand npm launchers - Node.js 22+ only when using the npm launcher
- Cloudcraft API key — generate one at https://app.cloudcraft.co/ → User settings → API keys
Install
Use an immutable version in client configuration so upgrades are deliberate.
uvx is delivered by the PyPI package; there is no separate uvx registry.
The npm package embeds the byte-identical Python wheel and invokes it through
uv, so the npm path requires both Node.js and uv. It does not download code
in a postinstall hook.
For development from a checkout:
Claude Desktop integration
Install uv, then add this entry to Claude Desktop's configuration. Prefer Claude's secret storage when available; the literal below is only a portable example.
Restart Claude Desktop. The Developer tab should show cloudcraft as connected.
See client setup for Cursor, Gemini CLI, npm, Docker, and MCPB examples.
Environment variables
Usage examples (in Claude)
Once the server is connected, ask Claude things like:
"List my Cloudcraft blueprints and summarize what each represents."
"Export blueprint
f0086b32-...as PNG and save it to my Desktop."
"Take the architecture I just designed and create a new Cloudcraft blueprint called 'Prod 2026'."
"Snapshot
ap-northeast-2of my connected AWS account, excluding security groups."
"Export the monthly budget of blueprint
f0086b32-...as CSV in EUR."
Blueprint payload shape
create_blueprint / update_blueprint accept the full Cloudcraft data object. A minimal payload:
Refer to Cloudcraft's API docs for the full node-type catalog and service-specific fields.
Development
Tests mock the HTTP layer with respx so no API key is required.
Coverage
CI uploads coverage.xml from the Python 3.12 matrix cell to
Codecov. The project gate
is 80% or higher — a PR that drops overall or patch coverage by more
than 1 percentage point below that line fails the Codecov check
(codecov.yml).
Run the same report locally:
Project layout
Design notes
- Transport / logic split.
client.pyis a plain async HTTP client you can import from scripts or CLI tools without pulling the MCP runtime.server.pyonly owns the MCP tool surface. - Bearer-token auth. Cloudcraft's API expects
Authorization: Bearer <key>(notApikey). The client sets this automatically. - No secrets in process args. The API key is read from
CLOUDCRAFT_API_KEY; never pass it on the command line. - One implementation. PyPI, npm, MCPB, and the container all launch the same versioned Python package rather than maintaining language-specific forks.
- Error surface. Non-2xx responses raise
CloudcraftErrorwith status and body preserved, re-wrapped asRuntimeErrorat the MCP boundary so Claude sees a readable message.
Security
- API keys grant full read / write over your Cloudcraft account. Treat them as secrets and rotate regularly.
- MCP tool annotations mark read-only tools and mutating/destructive tools so compatible hosts can present better approval prompts. These annotations are hints, not an enforcement layer.
- Environment gates and exact-ID delete confirmation are defense in depth, not an interactive approval workflow; keep the MCP host's tool approval UX enabled.
- Cloudcraft mutations are disabled by default. Set
CLOUDCRAFT_ENABLE_WRITES=trueonly for clients that need create/update access. Deletes additionally requireCLOUDCRAFT_ENABLE_DELETES=trueand an exact repeated blueprint ID on every call. delete_blueprintis irreversible — when asking Claude to delete, be explicit about the target id.export_blueprint_imagewrites are sandboxed underCLOUDCRAFT_EXPORT_DIR(a process-private temporary subdirectory by default) and refuse to overwrite existing files unlessoverwrite=True.- For read-heavy setups, create a dedicated Cloudcraft user with read-only scope (if/when Cloudcraft adds scoped keys) and use that key for MCP.
- Supported versions and private reporting instructions are in SECURITY.md; data flow is documented in PRIVACY.md.
Contributing
Issues and PRs welcome at https://github.com/hypark5540/cloudcraft-mcp. Please run ruff, mypy, and pytest before submitting.
License
MIT — see LICENSE.
Related
- Cloudcraft API documentation
- Model Context Protocol specification
- awslabs/mcp — AWS's collection of MCP servers
- modelcontextprotocol/servers — reference MCP server implementations
来源:README.md,提交 25ba3ab
工具
0版本历史
3- v0.1.8最新Oct 20, 2026
- v0.1.7Oct 8, 2026
- v0.1.6Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分