Umlout

io.github.dmkorj由 GitHub 账号 dmkorj 发布v1.2.0更新于 Oct 24, 2026

Build Umlout projects: objects with types and fields, relations, and boards that draw them.

已验证Streamable HTTP可网页运行效率与工作流开发者工具媒体与设计

概览

AI 生成的概览

Umlout 的托管 MCP 服务器,让助理在你的 Umlout 工作区创建项目、对象与关系,并绘制 UML、流程图、线框图等看板。

可以做什么
创建、列出、重命名、公开分享与删除项目,并在看板中创建、查找、重命名、清空与恢复看板。创建对象、文件夹与关系,更新或合并重复对象,并浏览类型目录、声明项目自有类型与字段。绘制对象图形、自由图形、UML 类与连接线、时序消息与自定义锚点,并批量更新或删除。上传、重命名、删除与恢复项目文件,并在图片图形中显示图像。添加、列出、解决与删除图形或线条上的评论与回复,列出并恢复已删除项目,查询方案配额与速率限制额度。
适用场景
适合在 Umlout 工作区中创建或修改图表时使用,例如把需求或 OpenAPI 规格转成 UML 类图、时序图、组件图,或把移动流程画成线框图;也适合让助理读取看板内容并检查图中缺漏。
运行要求
远程端点,无需本地安装。需要 Umlout 账号与 API 密钥,通过 Authorization 请求头以 Bearer 令牌发送;部分客户端改用浏览器 OAuth 登录。Claude Desktop 需经 mcp-remote 桥接并安装 Node.js。需要网络连接。
安装前请注意
需要 Umlout API 密钥(Authorization 请求头),请妥善保管并可在账号中轮换或撤销。工具可创建、修改、删除与恢复项目、看板、对象、关系、类型与文件,并可将项目公开分享,操作前请确认范围。助理只能看到你账号有权限的项目,但仍会把项目内容发送到 Umlout 托管服务。有速率限制:每分钟 300 次工具调用、每小时 600 次写入。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Umlout,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.dmkorj%2Fumlout/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "umlout": {
      "type": "http",
      "url": "https://www.umlout.com/mcp/http"
    }
  }
}

README

Umlout MCP Server

Let your AI assistant draw on a real whiteboard.

Umlout exposes a hosted Model Context Protocol server, so Claude, Cursor, VS Code Copilot and any other MCP client can build and edit projects in your Umlout workspace — UML class, sequence, activity and state boards, flowcharts, wireframes, agile and planning boards, floor plans, dashboards and cloud architecture drawn with the AWS, Azure and Kubernetes icon sets.

Nothing to install and nothing to run: the server is hosted at https://www.umlout.com/mcp/http (Streamable HTTP). The older SSE address, /mcp/sse, still answers, but an SSE session does not survive a restart of the service, so a client pointed at it fails after every deploy until it is reconnected by hand. Use /mcp/http. You only need an API key.


Quick start

1. Get an API key. Sign in at umlout.com, open Profile → AI clients, pick your client and create a key. The profile page gives the exact text for your client with the key already in it.

2. Add the server to your client.

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

More options, including project scope: examples/claude-code.md.

Cursor · VS Code

~/.cursor/mcp.json:

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

VS Code reads a different shape — servers, not mcpServers, and "type": "http" — so use examples/vscode.json in .vscode/mcp.json. It prompts for the key and keeps it in VS Code's secret storage instead of a committed file.

Claude Desktop — via the mcp-remote bridge

Claude Desktop's config file does not take a remote URL directly, so route it through mcp-remote (needs Node.js). Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Then quit Claude Desktop completely and reopen it — closing the window is not enough.

Codex · Gemini CLI · Antigravity · Devin Desktop · other clients

Codex keeps the key out of its config and reads it from an environment variable — see examples/codex.md.

Every other client takes a JSON file with an address and a headers object; only the name of the address field differs:

clientfileaddress field
Cursor~/.cursor/mcp.jsonurl
Gemini CLI~/.gemini/settings.jsonhttpUrl
Antigravity~/.gemini/config/mcp_config.jsonserverUrl
Devin Desktop (formerly Windsurf)its mcp_config.json (MCPs → View raw config)serverUrl
json
{  "mcpServers": {    "umlout": {      "serverUrl": "https://www.umlout.com/mcp/http",      "headers": { "Authorization": "Bearer YOUR_API_KEY" }    }  }}
ChatGPT · Claude connectors · Grok — clients that take only an address

No key: give the client https://www.umlout.com/mcp/http. It opens an Umlout page where you sign in and allow it. See docs/authentication.md.

3. Ask for a board:

Create a project "Auth" and draw a UML sequence diagram of the OAuth2 authorization code flow on a board in it.

Verify your setup at any time:

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

What it can do

95 tools across twelve areas, plus 4 read-only resources. Full reference with every argument: docs/tools.md and docs/resources.md.

Umlout stores a project, and a board is one view of it. A project holds objects — each with a name, exactly one type, its own properties and a description — and the relations between them. A figure on a board is one drawing of an object, so the same object can be drawn on five boards and is still one object; a line on a board is one drawing of a relation.

AreaWhat the assistant can do
ProjectsCreate, list, read, rename, share publicly and delete projects
BoardsCreate boards in a project, find them by name, rename, point the camera, clear, delete and restore
Objects and foldersCreate objects, folders and relations in one call; update, merge duplicates, give an object its own detail board
RelationsCreate and update relations with UML detail; reverse a relation's direction
Types and fieldsBrowse the catalogue's types; declare the project's own types; describe each type's fields — text, number, yes/no, choice, markdown, reference, counter, computed, file, list of pairs — and the template an object of the type is drawn with
Shared fieldsDescribe a field once and use it in several types
Shapes and connectionsDraw figures of objects and free figures, UML classes with their compartments, connections with UML notation, sequence messages, custom anchor points; update and delete one at a time or hundreds per call
Composite figures and palettesSave a set of figures as one card and place it again; redraw older copies; arrange the toolbar's palettes
FilesUpload files into a project, rename, delete and restore them; show an image in an Image figure
CommentsAdd, list, resolve and delete comments and replies on any figure or line
Deleted itemsList what was deleted in a project and restore it — a board, an object, a relation, a type, a shared field or a file
Plan and limitsRead the plan's quotas and what is left of the rate-limit budgets

The figure vocabulary covers 205 figures — basic geometry, UML (class, use case, state, activity, sequence, component, deployment, timing), flowchart, charts and dashboard figures, agile and retrospective cards, plans with stages and tasks, floor plans, and a full wireframe kit — plus the AWS, Azure and Kubernetes icon libraries.

Things worth asking for

  • "Turn this OpenAPI spec into a component diagram."
  • "Sketch the mobile onboarding flow as wireframes — three screens."
  • "Read the board 'Checkout' and tell me which states have no outgoing transitions."
  • "Build a project from these requirements: orders, invoices, customers — one type per noun, with their fields — and draw a class board of it."
  • "Add a status field to every Task and count the done ones on each Stage."

Authentication and limits

Every request carries your key in Authorization: Bearer <key> (or X-API-Key), or an OAuth token for a client that signs in through the browser. Both are scoped to your account — the assistant sees exactly the projects you can see, with the role you have in each, and nothing else.

LimitValue
Tool calls300 per minute
Write tool calls600 per hour
Bulk write calls (bulk_*)600 per hour, in addition to the write budget

Details, key rotation and revocation: docs/authentication.md. Something not working? docs/troubleshooting.md.


About this repository

This repo is the public home of the Umlout MCP connector: documentation, client configs, the registry manifest (server.json) and a connection checker. The server itself is a hosted service — there is no local installation, so there is no server source here.

Issues and questions about the MCP integration are welcome in Issues.

License

MIT — documentation and examples.

来源:README.md,提交 3aca44b

工具

0
该服务器需要登录,因此 SourceWeft 无法在没有账号的情况下读取其工具,也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

2
  1. v1.2.0最新Oct 6, 2026
  2. v1.0.0Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分