
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.
概览
Umlout 的托管 MCP 服务器,让助理在你的 Umlout 工作区创建项目、对象与关系,并绘制 UML、流程图、线框图等看板。
- 可以做什么
- 创建、列出、重命名、公开分享与删除项目,并在看板中创建、查找、重命名、清空与恢复看板。创建对象、文件夹与关系,更新或合并重复对象,并浏览类型目录、声明项目自有类型与字段。绘制对象图形、自由图形、UML 类与连接线、时序消息与自定义锚点,并批量更新或删除。上传、重命名、删除与恢复项目文件,并在图片图形中显示图像。添加、列出、解决与删除图形或线条上的评论与回复,列出并恢复已删除项目,查询方案配额与速率限制额度。
- 适用场景
- 适合在 Umlout 工作区中创建或修改图表时使用,例如把需求或 OpenAPI 规格转成 UML 类图、时序图、组件图,或把移动流程画成线框图;也适合让助理读取看板内容并检查图中缺漏。
- 运行要求
- 远程端点,无需本地安装。需要 Umlout 账号与 API 密钥,通过 Authorization 请求头以 Bearer 令牌发送;部分客户端改用浏览器 OAuth 登录。Claude Desktop 需经 mcp-remote 桥接并安装 Node.js。需要网络连接。
安装
在 SourceWeft 中
- 打开 控制台中的 Umlout,将其添加到工作区。
- 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
- 为需要使用其工具的对话启用该服务。
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
More options, including project scope: examples/claude-code.md.
Cursor · VS Code
~/.cursor/mcp.json:
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):
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:
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:
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.
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
statusfield 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.
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版本历史
2- v1.2.0最新Oct 6, 2026
- v1.0.0Sep 16, 2026
评分
已满足适用检查项的 85%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通必需25 分
- 已声明认证方式必需10 分
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分