mcpField
C
CloudArch

CloudArch

本地服务
web.cloud-arch.ru媒体与设计
代码仓库访问官网

关于 CloudArch

从提示词或脚本在 CloudArch 上创建和更新实时动画架构图。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "ru-cloud-arch-cloudarch": {
      "command": "npx",
      "args": [
        "-y",
        "@cloud-arch/mcp-server"
      ],
      "env": {
        "CLOUDARCH_API_KEY": "<CLOUDARCH_API_KEY>",
        "CLOUDARCH_API_URL": "<CLOUDARCH_API_URL>"
      }
    }
  }
}
启动命令npx -y @cloud-arch/mcp-server
需要配置的环境变量
CLOUDARCH_API_KEY密钥CloudArch API key (create one at https://web.cloud-arch.ru/workspace/api)
CLOUDARCH_API_URLAPI base URL override for self-hosted instances (default https://api.cloud-arch.ru)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@cloud-arch/mcp-server0.2.2

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
codestring是CloudArch 脚本代码——必填。请先调用 get_script_template：其中包含布局规则（每 3-4 个节点调用一次 .newRow()）、场景 API（.scenario/.showError/.flashError）和架构模式。必须使用 TopologyBuilder/FlowBuilder 全局对象，调用 await topology.apply()，并以 'return flow;' 结束。不得使用 import/export。
namestring否图表名称。省略时自动生成。
slugstring否图表的 URL slug（小写字母，以连字符分隔）。省略时自动生成。
tagsarray否用于分类的标签
readmestring否图表的 Markdown README。强烈建议提供——否则查看器的 README 面板会显示空卡片，失去教育价值。目标长度约为 150-400 个词。建议的部分：## Overview、## Components（node-id → role 表格）、## Scenarios（分步骤说明动画展示的内容以及哪些节点会亮起）、## Tradeoffs / Failure modes、## References。在正文中使用 `:concept{slug="..."}` 和 `:case{slug="..."}`；双冒号叶节点形式仅在独占一行时有效。使用与相应部分匹配的准确公共 slug。使用普通 Markdown 将相关图表链接到 `/v/<slug>`；切勿编造 slug 或留下失效徽标。使用 [LABEL] 前缀匹配 showMessage() 输出；切勿使用表情符号。调用 get_script_template 获取完整的编写指南。
isPublicboolean否图表是否公开可见。默认为 FALSE：根据他人代码库创建的图表不应出现在公共图库中，除非用户明确提出要求。请审慎传入 true。
descriptionstring是要可视化的系统架构自然语言描述。请具体说明组件、连接关系和数据流。

详细介绍

维护者还没有提供详细介绍，可以先查看代码仓库中的 README。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。