Cloudcraft.co 的模型上下文协议 (MCP) 服务器 — 可从 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)
Cloudcraft API 密钥 — 在 https://app.cloudcraft.co/ → 用户设置 → API 密钥处生成
克隆仓库并让 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编辑 ~/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。开发者选项卡应显示 cloudcraft 已连接。
名称 | 必需 | 默认 | 用途 |
| 是 | — | API 密钥 (Bearer)。在 Cloudcraft 用户设置中生成。 |
| 否 |
| 用于代理或未来 API 版本的覆盖。 |
| 否 |
| Stderr 日志详细程度 ( |
服务器连接后，您可以询问 Claude 诸如：
“列出我的 Cloudcraft 蓝图并总结每个蓝图代表的内容。”
“将蓝图
f0086b32-...导出为 PNG 并保存到我的桌面。”
“使用我刚刚设计的架构创建一个名为 'Prod 2026' 的新 Cloudcraft 蓝图。”
“为我已连接的 AWS 账户对
ap-northeast-2中的 EC2 实例进行快照。”
create_blueprint / update_blueprint 接受完整的 Cloudcraft data 对象。一个最小的有效负载：
{
"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
}有关完整的节点类型目录和服务特定字段，请参阅 Cloudcraft 的 API 文档。
uv sync --extra dev
uv run pytest # unit tests (no network)
uv run ruff check . # lint
uv run mypy src # type check测试使用 respx 模拟 HTTP 层，因此不需要 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 客户端，您可以在脚本或 CLI 工具中导入它，而无需引入 MCP 运行时。server.py 仅负责 MCP 工具接口。
Bearer 令牌认证。 Cloudcraft 的 API 需要 Authorization: Bearer <key> (而不是 Apikey)。客户端会自动设置此项。
进程参数中无密钥。 API 密钥从 CLOUDCRAFT_API_KEY 读取；切勿在命令行上传递它。
错误处理。 非 2xx 响应会引发保留状态和主体的 CloudcraftError，并在 MCP 边界处重新包装为 RuntimeError，以便 Claude 能看到可读的消息。
API 密钥授予对您 Cloudcraft 账户的完全读/写权限。请将其视为机密并定期轮换。
delete_blueprint 是不可逆的 — 当要求 Claude 删除时，请明确指定目标 ID。
对于读取密集型设置，请创建一个具有只读范围的专用 Cloudcraft 用户（如果/当 Cloudcraft 添加范围密钥时），并将该密钥用于 MCP。
欢迎在 https://github.com/hypark5540/cloudcraft-mcp 提交问题和 PR。提交前请运行 ruff、mypy 和 pytest。
MIT — 参见 LICENSE。
awslabs/mcp — AWS 的 MCP 服务器集合
modelcontextprotocol/servers — 参考 MCP 服务器实现
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
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.
OCR, transcription, file extraction, and image generation for AI agents via MCP.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/hypark5540/cloudcraft-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server