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 分