Umlout

Umlout MCP 服务

让 AI 助手在真实白板上绘图。

Umlout 提供托管的 Model Context Protocol 服务，让 Claude、Cursor、VS Code Copilot 和其他任何 MCP 客户端都能在你的 Umlout 工作区中创建和编辑项目——包括 UML 类图、时序图、活动图和状态图、流程图、线框图、敏捷与规划看板、平面图、仪表板，以及使用 AWS、Azure 和 Kubernetes 图标集绘制的云架构。

无需安装，也无需运行任何程序：服务托管在 https://www.umlout.com/mcp/http（Streamable HTTP）。较旧的 SSE 地址 /mcp/sse 仍可响应，但服务重启后 SSE 会话不会保留，因此每次部署后，指向该地址的客户端都会失效，直到手动重新连接。请使用 /mcp/http。 你只需要一个 API 密钥。

快速开始

1. 获取 API 密钥。 在 umlout.com 登录，打开 Profile → AI clients，选择你的客户端并创建密钥。个人资料页面会提供适用于该客户端的准确配置文本，并已填入密钥。

2. 将服务添加到你的客户端。

claude mcp add --transport http umlout https://www.umlout.com/mcp/http --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "umlout": {
      "url": "https://www.umlout.com/mcp/http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "umlout": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://www.umlout.com/mcp/http",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

{
  "mcpServers": {
    "umlout": {
      "serverUrl": "https://www.umlout.com/mcp/http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

3. 请求创建看板：

创建一个名为 “Auth” 的项目，并在其中的看板上绘制 OAuth2 授权码流程的 UML 时序图。

你可以随时验证配置：

python3 scripts/check_connection.py --api-key YOUR_API_KEY

能做什么

覆盖十二个领域的 95 个工具，以及 4 个只读资源。包含每个参数的完整参考： docs/tools.md 和 docs/resources.md。

Umlout 存储的是一个项目，而画板是查看项目的一种视图。项目包含对象——每个对象都有名称、且只有一种类型，以及自己的属性和描述——还有对象之间的关系。画板上的图形是对象的一种绘制方式，因此同一对象可以绘制在五个画板上，但它仍然是同一个对象；画板上的线则是关系的一种绘制方式。

图形词汇库涵盖 205 种图形——基本几何图形、UML（类、用例、状态、活动、序列、组件、部署、时序）、流程图、图表和仪表板图形、敏捷和回顾卡片、带阶段和任务的计划、平面图，以及完整的线框图套件——此外还有 AWS、Azure 和 Kubernetes 图标库。

值得尝试的请求

• “将这个 OpenAPI 规范转换为组件图。”
• “把移动端引导流程绘制成线框图——共三个屏幕。”
• “阅读‘Checkout’画板，并告诉我哪些状态没有出向转换。”
• “根据这些需求构建一个项目：订单、发票、客户——每个名词对应一种类型及其字段——并为其绘制类图画板。”
• “为每个 Task 添加一个 status 字段，并统计每个 Stage 中已完成的任务数量。”

身份验证和限额

每个请求都通过 Authorization: Bearer <key>（或 X-API-Key）携带你的密钥，或者携带通过浏览器登录的客户端所用的 OAuth 令牌。两种方式都限定在你的账户范围内——助手看到的项目、你在每个项目中的角色都与你完全相同，不会看到其他内容。

详情、密钥轮换和撤销： docs/authentication.md。 遇到问题？docs/troubleshooting.md。

关于此代码仓库

此代码仓库是 Umlout MCP 连接器的公开主页：包含文档、客户端配置、注册清单（server.json）和连接检查工具。服务本身托管在远程服务上——无需本地安装，因此此处不包含服务源代码。

欢迎在 Issues 中提出有关 MCP 集成的问题或疑问。

许可证

MIT — 文档和示例。