Skip to main content
Glama

draw_deployment_diagram

Draw UML deployment diagrams to map components and artifacts onto nodes and communication paths, then export PNG with reusable input and validate for overlaps, crossed lines, and label collisions.

Instructions

배치도(deployment diagram)를 그려 PNG와 입력 파일로 저장하고, 검사 결과와 그림을 함께 돌려준다. 소프트웨어(컴포넌트·아티팩트)가 어느 컴퓨터(노드)에 놓여 도는지 보인다. 노드 안에 컴포넌트·아티팩트·노드를 넣고, 노드끼리 통신 경로를, 노드 밖 요소에서 노드로 «deploy»를 긋는다. 컴포넌트·아티팩트는 아이콘 표기로도 그리고, 클래스·패키지 요소도 한 그림에 섞어 그릴 수 있다. 요소는 준 왼쪽 위(left·top) 그대로, 관계선은 준 꺾는 점(via)을 따라 그리고, 요소 크기·선 끝·선 글자 자리만 도구가 정한다. 좌표는 px이고 y는 아래로 커진다.

입력 필드는 인자마다 붙은 설명에 있다.

결과

  • 글: 검사 결과, 요소마다 그린 자리(열쇠와 왼, 위, 폭×높이), 저장한 그림·입력 파일 경로와 그림 픽셀 크기. 자리를 그대로 다음 입력에 넣으면 요소가 움직이지 않는다. 모양 밖 이름이 있는 요소의 자리는 모양과 이름을 함께 덮고, 그 뒤에 모양 자리를 "모양 왼, 위, 폭×높이"로 덧붙인다(꺾는 점을 모양 둘레에 줄 때 쓴다). 선이 모양 가운데에서 비켜난 점을 향하는 요소(kind "package"·"component_icon")는 그 뒤에 그 점을 "향하는 점 x, y"로 덧붙인다(꺾는 점을 그 점의 위아래나 옆에 줄 때 쓴다). 같은 부모로 상속·실체화가 함께 오는 요소는 그 요소의 자리 뒤에 종류마다 향하는 점을 "상속 향하는 점 x, y, 실체화 향하는 점 x, y"로 덧붙인다(마지막 꺾는 점 — 꺾는 점이 없으면 자식 가운데 — 이 그 점 바로 아래인 그 종류의 선이 그 점을 향한다. 공유 줄기를 종류마다 그 점으로 모을 때 쓴다. 모양이 좁아 두 종류의 삼각형이 나란히 들지 않으면 덧붙지 않는다).

  • 그림: 저장한 PNG. 긴 변이 1568px를 넘으면 그 길이로 줄여 돌려준다(저장한 그림은 줄이지 않는다).

  • 입력 파일: 그림 옆 <file_name>.cysuml.json에 그린 도구 이름(tool)과 이 입력(out_dir만 빼고)을 저장한다. 있던 그림을 고칠 때는 이 파일을 읽어 고친 뒤 out_dir에 그 폴더를 주어 tool의 도구로 다시 그린다 — 그대로 넣으면 같은 그림이 나온다(tool은 도구가 무시한다).

  • elements·relations·file_name이 틀리면 그리지 않고 틀린 곳을 elements[0].left 꼴 자리와 함께 모두 모아 오류로 돌려준다. 그림이 너무 커서 PNG로 그릴 수 없거나 저장할 폴더에 쓸 수 없을 때도 오류로 돌려준다.

AI가 배치하는 그림(클래스도·패키지도 등)을 그리는 흐름 — 검사에 합격할 때까지 되풀이한다:

  1. 요소(클래스도에서는 상자)의 자리(left·top)와, 필요하면 관계선의 꺾는 점(via)을 정해 그린다.

  2. 돌려받은 검사 결과와 그림을 본다. 불합격 항목마다 걸린 요소, 자리(논리 좌표 왼, 위, 폭×높이), 고치는 법이 붙는다. 고치는 법은 종류마다 다르니(요소를 옮긴다, 꺾는 점을 고친다, 두 요소를 떼어 놓는다 등) 항목에 적힌 대로 고친다.

  3. 고친 입력을 같은 file_name으로 다시 그린다(파일을 덮어쓴다). 관계 이름은 도구가 그 관계의 선 위에 얹는다(이름 앞뒤로 선이 끊긴다). 얹을 빈 자리가 없는 이름(선이 짧아 이름 앞이나 뒤에 선이 거의 보이지 않을 때도)과 같은 요소로 돌아오는 선의 이름은 선 옆에 두고, 얹으면 그림 전체에서 걸리는 곳이 더 많아질 때는 모든 이름을 선 옆에 둔다. 다중도는 선 끝 옆에 둔다. 선끼리 엇갈린 곳, 표기 규칙 알림(관계 규칙이 있는 도구에서 뜻을 확인해 볼 관계), 그림 크기는 알림이라 불합격이 아니다. 다만 엇갈림은 적을수록 읽기 좋다.

불합격(선이 요소나 글자를 지나는 등 문서에 넣을 수 없는 그림) 14가지: 요소끼리 겹치거나 붙음, 안의 요소가 바깥 요소의 칸 밖으로 나가거나 테두리·이름 칸에 붙음, 선이 그 선과 상관없는 요소를 지나감, 선이 끝 요소의 몸통 밖 자리(이름 칸 등)나 끝을 품은 요소의 이름 칸을 지나감, 선이 끝을 품은 요소의 테두리를 따라감, 선이 끝 요소 테두리에 붙어 감, 선 끝 모양이 그 선의 다른 끝 요소 테두리에 붙음, 선 끝 모양이 그 끝의 요소 안으로 들어감, 선끼리 포개지거나 선이 왔던 길을 되짚음, 선이 선 끝 모양에 닿음, 선 끝 모양끼리 겹침, 선이 선 글자(관계 이름·다중도 등)를 지나감(이름이 얹힌 그 관계의 선 구간은 빼고), 선 글자가 요소에 겹침, 선 글자끼리 겹침.

배치도(deployment diagram) 자리 잡기 요령:

  • 사용자 쪽 노드(PC·휴대폰 등)를 한쪽 끝에, 서버·데이터베이스 노드를 다른 쪽으로 차례로 놓아 통신 경로가 엇갈리지 않게 한다.

  • 통신 경로는 두 노드의 가운데를 잇는다. 가로 한 줄에 놓은 노드는 top과 height를, 세로 한 단에 쌓은 노드는 left와 width를 같게 주면 경로가 곧다. 노드는 안의 요소에 맞춰 늘어나니, 결과의 "요소 자리"에서 그 줄(단)의 가장 높은(넓은) 노드 크기를 다른 노드의 height(width)로 준다. 안의 요소를 바꿔 노드가 다시 늘면 다시 맞춘다.

  • 노드 안의 요소는 이름 한 줄 노드면 노드 top + 52부터 두고, 스테레오타입(«device» 등)이나 이름 줄이 하나 늘 때마다 14px씩 더 아래부터 둔다(«device» 노드면 top + 66, 이름이 두 줄인 «device» 노드면 top + 80).

  • 노드 밖에서 노드 안의 요소(노드 안의 노드 포함 — 아래에서 "끝 요소")로 가는 선이 끝 요소를 품은 노드들의 이름(앞면 위 가운데)을 지나면 불합격이다. 선을 보내는 요소는 가장 바깥 노드의 옆에 끝 요소와 같은 높이로(보내는 요소의 top을 끝 요소의 윗변과 아랫변 사이에) 두거나, 아래에 끝 요소와 같은 가로 자리로(보내는 요소의 left를 끝 요소의 왼변과 오른변 사이에) 둔다. 왼쪽·오른쪽·아래 가운데 노드 테두리에서 끝 요소까지 가는 길에 다른 요소가 없는 쪽을 고른다. 그 선의 글자(«deploy»·프로토콜 이름)는 도구가 선을 따라 노드 테두리를 비킨 자리에 놓으니, 가장 바깥 노드와는 그 글자가 들어갈 만큼 띄우면 된다 — 옆이면 가장 긴 줄의 글자 폭 + 15px, 아래·위면 글자 줄 수 × 15 + 가장 긴 줄의 글자 폭 ÷ 4 + 25px 이상이다. 글자 폭은 영문·숫자·ASCII 기호 한 글자 11px(W·@·%는 14px), 한글 12px, 그 밖의 글자 14px로 넉넉히 어림하고, 불합격 항목에 글자 자리(폭×높이)가 나오면 그 폭으로 고친다. 어림은 넉넉한 값이라, «deploy» 한 줄은 실제로는 요소 사이 기본 간격("요소 사이는" 항목)에도 들어간다.

  • 끝 요소가 가장 바깥 노드 바로 안의 노드이면 선을 보내는 요소를 위에 둘 수도 있다. 이름 칸 바로 위는 피하고, 이름 칸에서 보내는 요소 쪽으로 40px쯤 바깥, 이름 칸 아랫변에서 10px 아래에 꺾는 점(via)을 하나 준다(이름 칸 옆 앞면이 40px보다 좁아 꺾는 점이 앞면 밖(두께 띠나 노드 밖)에 놓여도 된다. 이름 칸 자리는 불합격 항목의 "이름 칸"에 나온다). 보내는 요소가 바깥 노드 오른쪽 위 모서리 근처라 꺾는 점까지 가는 선이 그 모서리의 비스듬한 두께 띠 선을 따라가 불합격하면, 보내는 요소를 옆으로 20px쯤 옮긴다. 끝 요소가 더 깊으면 위에 두지 않는다 — 이 꺾는 점으로는 안쪽 노드의 이름을 비키지 못한다.

  • 요소 사이는 관계 이름·스테레오타입 글자가 들어갈 만큼 띄운다. 가로 80px·세로 60px쯤에서 시작하고, 글자가 길면 더 띄운다.

  • 요소 크기는 도구가 글자와 안의 요소에 맞춰 늘린다. 그린 크기는 결과의 "요소 자리"에서 보고 다음 입력에 쓴다.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "file_name": "<file_name>",
      "elements": "<elements>"
    },
    "name": "draw_deployment_diagram"
  }
}

Input Schema

NameRequiredDescriptionDefault
scaleNo출력 배율(기본 1.6, 0.25 이상). 보통은 주지 않는다.
out_dirNo저장할 폴더. 주지 않으면 서버 작업 폴더 아래 diagrams/이고, 상대 경로도 서버 작업 폴더 기준이다.
elementsYes- elements: 요소 목록(하나 이상). 종류를 섞어 한 그림에 그린다. - kind(필수): "class"·"abstract"·"interface"·"enum"(클래스 상자 — 인터페이스는 «interface» 상자다), "package"(탭 달린 폴더 — 이름은 탭에 쓰고 안에 요소를 둔다), "component"(오른쪽 위에 부품 아이콘을 단 상자), "artifact"(오른쪽 위에 문서 아이콘을 단 상자 — 이름은 흔히 파일 이름), "component_icon"(UML 1 표기 컴포넌트 — 왼쪽 변에 작은 네모(부품 네모) 둘이 걸쳐 튀어나온 상자, 이름은 상자 안), "artifact_icon"(문서 아이콘 표기 아티팩트 — 귀 접힌 문서 아이콘을 그리고 이름은 그 밖에 쓴다), "node"(오른쪽과 위에 두께가 보이는 입체 상자 — 이름은 앞면 위쪽에 쓰고 안에 요소를 둔다). - name(필수)·id: "공용 입력(열쇠·이름)" 절. - left·top(필수): 자리의 왼쪽 위(패키지는 탭, 노드는 두께 띠, UML 1 표기 컴포넌트는 부품 네모, 문서 아이콘 아티팩트는 이름까지 덮는 자리). - stereotype: «» 없이 이름만. 이름 위 줄에 쓴다(component·subsystem·device·executionEnvironment 등). 문서 아이콘 아티팩트는 받지 않는다. - in: 이 요소를 품은 요소(package·node)의 열쇠. "요소 안에 요소 두기(중첩)" 절. - width·height: 자리의 최소 크기. 글자와 안의 요소에 맞춰 더 늘어난다. 문서 아이콘 아티팩트는 크기가 정해져 있어 받지 않는다. - name_side: 이름을 모양 밖에 쓰는 요소의 이름 쪽 "bottom"·"top"·"left"·"right"(첫째가 기본). 요소 자리는 모양과 이름을 함께 덮고, left·top은 그 자리의 왼쪽 위다. 선 끝은 모양 테두리에 닿고, 어떤 선이든 이름을 지나가면 불합격이다. 이름을 모양 밖에 쓰는 종류만 받는다 — 위 종류 가운데서는 "artifact_icon"이다. - attributes·operations·literals: 클래스 상자만 쓴다(literals는 kind가 "enum"일 때). 속성·연산은 한 줄 문자열(그대로 쓴다)이나 객체다. 속성 객체는 name(필수)·type·default·visibility(기본 "-")·static, 연산 객체는 name(필수)·params(문자열 목록)·returns·visibility(기본 "+")·static. visibility는 "+"·"-"·"#"·"~"·""(안 씀)이고, static이 true면 밑줄을 긋는다. - 선은 패키지 몸통(탭 아래), 노드 겉 테두리, UML 1 표기 컴포넌트는 부품 네모를 뺀 상자, 문서 아이콘 아티팩트는 문서 아이콘 테두리, 그 밖은 상자 테두리에 닿는다. 선이 향하는 점은 UML 1 표기 컴포넌트는 부품 네모를 뺀 상자의 가운데(자리 가운데보다 튀어나온 폭의 반 4px 오른쪽), 문서 아이콘 아티팩트는 문서의 가운데(결과의 모양 자리 가운데)이고, 둘 다 반 픽셀이면 정수로 내린다 — 다른 요소와 곧게 이으려면 그 점에 가운데를 맞춘다. 부품 네모는 그 컴포넌트가 끝인 선도 지나가면 안 되므로, UML 1 표기 컴포넌트에 왼쪽에서 오가는 선은 가로로 곧게 긋는다(꺾는 점을 주면 그 컴포넌트 쪽 끝에 붙은 꺾는 점 — 들어오는 선은 마지막, 나가는 선은 첫 꺾는 점 — 을 선이 향하는 점과 같은 높이에 둔다. 그래서 왼쪽으로는 선 하나만 잇는다). 패키지 탭은 그 패키지가 끝인 선도 지나가면 안 되므로, 패키지로 오가는 선은 몸통 가운데가 아니라 탭 오른쪽 몸통의 가운데를 향한다. 안의 요소를 두는 칸은 패키지는 탭 아래 몸통, 노드는 이름 줄 아래 앞면(두께 띠 빼고)이다 — 칸 윗변은 패키지 top에서 탭 높이만큼, 노드 top에서 두께 8px과 이름 줄 높이만큼 아래다. 탭과 이름 줄 높이는 이름 한 줄이면 24px이고, 스테레오타입이나 이름 줄이 하나 늘 때마다 14px씩 더한다(그래서 안의 요소는 이름 한 줄 패키지면 top + 44, 노드면 top + 52부터 둔다). 공용 입력(열쇠·이름): - id: 요소의 열쇠. 관계의 from·to와 in이 이 열쇠로 요소를 가리킨다. 주지 않으면 한 줄 이름이 곧 열쇠다. 이름이 여러 줄이거나 이름이 없는 요소, 이름이 같은 요소는 id를 준다. 열쇠는 서로 달라야 한다. - name: 한 줄이면 문자열, 여러 줄이면 줄마다 문자열인 목록(["주문", "관리"]). 도구는 줄을 나누지 않으니 긴 이름은 목록으로 나눈다. 한 줄 안에 줄바꿈 글자는 넣지 못한다. 관계 name도 여러 줄 목록을 받는다. - 관계의 stereotype: «» 없이 이름만(include·extend·deploy·manifest·use 등). 관계 종류를 새로 만들지 않고 어느 관계에든 단다 («deploy»는 의존에). 관계 이름 위 줄에 쓴다. 요소 안에 요소 두기(중첩): - 안의 요소에 in으로 품은 요소의 열쇠를 준다. 여러 겹도 된다. 좌표는 늘 그림 전체 기준이다. - 바깥 요소는 준 왼쪽 위에서 시작해, 안의 요소를 여백 20px를 두고 덮도록 오른쪽·아래로 늘어난다(바깥 요소의 이름 칸이 들어갈 크기보다 작아지지 않는다). 그래서 안의 요소는 바깥 요소의 칸(안의 요소를 두는 곳) 왼쪽·위 테두리에서 20px 이상 들여 놓는다. - 선의 끝 요소를 품은 바깥 요소는 그 선이 안을 지나거나 테두리를 건너도 된다. 다만 테두리를 따라가거나 이름 칸을 지나면 불합격이다. 그 선의 글자도 바깥 요소 안에 놓일 수 있다. 그 밖의 요소는 선이 지나가면 불합격이다. - 품은 요소와 그 안의 요소는 선으로 잇지 않는다. 배치도(deployment diagram) 표기: - 노드 안에 두기: 노드에서 도는 컴포넌트·아티팩트, 노드 안의 노드(서버 안의 실행 환경 등)는 in으로 그 노드 안에 둔다. - 통신 경로: 노드끼리 kind "association"으로 잇는다. 이 도구의 연관은 navigable 기본이 "none"이라 화살촉 없는 실선이다(클래스끼리 이은 연관·집합·합성도 같으니, 화살촉이 필요하면 navigable을 준다). 선 위에 프로토콜 같은 이름(name — "HTTPS"·"JDBC" 등)이나 stereotype을 쓴다. - «deploy»: 노드 밖에 둔 컴포넌트·아티팩트에서 노드로 kind "dependency", stereotype "deploy"를 긋는다(점선 화살표). 한 그림에서 어떤 요소는 노드 안에 두고 어떤 요소는 «deploy»로 이어도 된다. 다만 노드 안에 둔 요소에서 그 노드(나 그 노드를 품은 노드)로는 긋지 않는다 — 품은 요소와 그 안의 요소를 잇는 선은 입력 오류다. - «manifest»: 아티팩트에서 그 아티팩트가 담은 컴포넌트로 kind "dependency", stereotype "manifest"를 긋는다. UML 2의 정석은 아티팩트를 노드에 두고(안에 두거나 «deploy»로) 컴포넌트는 그 아티팩트에서 «manifest»로 잇는 것이고, 컴포넌트를 노드 안에 바로 두는 간단한 표기도 흔히 쓴다. 한 문서 안에서는 한 가지로 맞춘다. - 노드 종류: 노드의 stereotype에 "device"·"executionEnvironment" 등을 주면 이름 위 줄에 쓴다. 모양은 같은 입체 상자다.
file_nameYes저장할 파일 이름(확장자 없이). 그림(.png)과 입력 파일(.cysuml.json)에 쓰고, 같은 이름이면 둘 다 덮어쓴다.
relationsNo- relations: 관계 목록(없어도 된다). - kind(필수): "association"·"aggregation"·"composition"·"generalization"·"realization"·"dependency". - from·to(필수): 요소 열쇠. 상속·실체화·의존은 from이 자식·구현하는 쪽·의존하는 쪽이고 삼각형·화살촉이 to 쪽에 붙는다. 집합·합성의 마름모는 from 쪽에 붙는다. - name: 관계 이름. stereotype: elements 인자 설명의 "공용 입력(열쇠·이름)" 절. - from_multiplicity·to_multiplicity·navigable: 연관·집합·합성만 쓴다. navigable은 화살촉을 둘 쪽 "to"·"from"·"both"·"none"(기본)이다(집합·합성은 "to"·"none"만). - via: 꺾는 점 [[x, y], …]. 선은 요소 가운데(요소 종류에 따로 적은 모양은 그 점)에서 첫 꺾는 점(없으면 상대 요소의 그 점)으로 가는 선이 요소 테두리와 만나는 곳에서 시작한다. 자기 자신으로 가는 관계는 꺾는 점이 둘 이상 있어야 한다(상속·실체화는 꺾는 점이 있어도 자기 자신으로 갈 수 없다). 화살촉 쪽 끝 구간을 꺾을 때는 그 꺾는 점을 요소 테두리에서 20px 이상 뗀다(앞 구간이 화살촉 쪽으로 비스듬히 되돌아오면 더 뗀다) — 화살촉 길이(10px)만큼만 떼면 꺾은 앞 구간이 화살촉 갈래 끝에 붙어 불합격이다. - 공유 줄기: 같은 부모(to)로 가는 상속끼리, 실체화끼리는 여러 선을 한 줄기로 모아 삼각형 하나를 함께 쓰게 그려도 된다. 삼각형이 정확히 같은 자리에 그려지면 그 선들이 포개져도 불합격이 아니다(종류가 다른 선을 섞거나 삼각형이 조금이라도 어긋나면 불합격이다). 부모를 위에, 자식들을 그 아래 한 줄에 두고(모양 밖 이름은 name_side "left"·"right"로 옆에 쓴다 — 위·아래면 줄기가 이름을 지난다) 이렇게 준다: - 가운데 x·y: 결과의 요소 자리에서 왼 + 폭/2, 위 + 높이/2 — 모양 자리가 덧붙어 있으면 모양 자리로 셈한다(반 픽셀이면 정수로 내린다). 관계 이름이 붙지 않은 "향하는 점 x, y"가 덧붙어 있으면 그 점을 쓴다. - 줄기 높이 y는 부모 요소의 아래 테두리와 자식 요소들의 위 테두리(모양 자리가 덧붙어 있으면 모양 자리의 변) 사이 가운데쯤에 정한다. 부모 아래 테두리에서 삼각형 길이 18px보다 가까우면 입력 오류다. - 자식(from)마다 via에 [자식 가운데 x, y]와 [부모 가운데 x, y] 두 점을 준다. 마지막 점이 모두 같아 삼각형이 한 자리에 그려진다. 자식 가운데 x가 부모 가운데 x와 같으면 두 점이 같아지니 [부모 가운데 x, y] 하나만 준다. - 같은 부모로 상속·실체화가 함께 오면 종류마다 향하는 점이 정해진다 — 상속은 가운데에서 왼쪽으로 15px, 실체화는 오른쪽으로 15px이고, 결과의 그 부모 자리 뒤에 "상속 향하는 점 x, y, 실체화 향하는 점 x, y"로 덧붙는다(덧붙은 값을 그대로 쓴다). 상속 선은 상속 향하는 점, 실체화 선은 실체화 향하는 점 바로 아래(x가 같게 — 5px 안이면 그 점에 맞춘다)에 마지막 꺾는 점을 두면 그 점을 향해 곧게 들어가 두 종류의 삼각형이 나란히 놓인다. 꺾는 점 없이 곧게 잇는 선은 자식 가운데가 그 점 바로 아래면 그 점을 향하고, 그 밖의 선은 그대로 가운데를 향한다. 그러니 위 두 점의 [부모 가운데 x, y] 대신 상속 자식은 [상속 향하는 점의 x, 줄기 높이 y]를, 실체화 자식은 [실체화 향하는 점의 x, 줄기 높이 y]를 주어 종류마다 줄기를 따로 모은다(자식 가운데 x가 그 점의 x와 같으면 그 점 하나만 주거나 꺾는 점 없이 곧게 잇는다). - 상속 자식의 가운데 x가 모두 실체화 향하는 점과 실체화 자식들보다 10px 이상 왼쪽에 있고, 실체화 자식의 가운데 x가 모두 상속 향하는 점보다 10px 이상 오른쪽에 있으면 두 가로 줄기가 떨어지니 같은 높이 y에 둔다. 아니면 같은 높이에서 두 가로 줄기가 포개지거나 한 줄로 이어져 보이니, 한 종류의 줄기를 y + 20(자식 쪽)에 둔다. 그때 위 줄기 종류의 자식 가운데 x가 다른 종류의 향하는 점 x에서 4px 안이면 세로 줄끼리 포개지니 그 자식을 옮긴다. - 종류마다 향하는 점이 있으면 줄기 높이 y(두 높이면 위 줄기)를 부모 아래 테두리에서 28px(삼각형 길이 + 10) 이상 떼어 다른 종류의 삼각형 밑을 지나지 않게 한다. 줄기를 y와 y + 20 두 높이에 둘 때는(위 항목과 아래 좁은 부모 항목) 아래 줄기를 자식 요소들의 위 테두리보다 10px 이상 위에 둔다 — 부모와 자식 사이를 60px 이상 띄우고 y를 부모와 자식 사이 한가운데에 두면 다 맞는다. - 결과의 부모 자리 뒤에 종류마다 향하는 점이 덧붙지 않으면(부모 아래 테두리가 48px보다 좁아 삼각형 둘이 나란히 들지 않을 때 등) 한 종류만 위대로 아래 테두리 가운데에 모으고, 다른 종류는 옆 테두리로 들인다. 세로 줄 x2 = 부모 오른쪽 테두리의 x(왼 + 폭, 모양 자리가 덧붙어 있으면 모양 자리로) + 30로 정하고, 그 종류의 자식마다 via에 [자식 가운데 x, y + 20], [x2, y + 20], [x2, 부모 가운데 y] 세 점을 준다(자식 가운데 x가 x2와 같으면 [x2, 부모 가운데 y] 하나만)(부모의 모양 밖 이름이 오른쪽에 있으면 처음부터 다음 문장의 왼쪽 x2로 왼쪽 테두리에 들인다). x2 줄(y + 20에서 부모 가운데 y까지)에 다른 요소가 걸리거나, 부모 오른쪽 테두리에 다른 선이 닿거나, 아래 테두리로 가는 자식의 가운데 x가 x2에서 4px 안이면 거울처럼 x2 = 부모 왼쪽 테두리의 x(왼, 모양 자리가 덧붙어 있으면 모양 자리로) − 30로 두어 왼쪽 테두리로 들인다. 양쪽 다 막히면 걸린 요소를 옮기거나 자식 차례를 바꾼다. - 규칙: 상속은 같은 종류끼리 긋는다("class"·"abstract"끼리, "interface"끼리, "enum"끼리, "component"·"component_icon"끼리, "artifact"·"artifact_icon"끼리, "node"끼리). 상속의 끝이 될 수 없는 종류: "package". 클래스가 인터페이스를 구현하는 것은 realization이다. 종류가 다른 상속, 고리를 이루는 상속(A가 B를, B가 다시 A를 상속하는 것 — 여러 단계도)은 입력 오류다. - 알림: 다음 실체화는 그리되 검사 결과에 알림을 준다(불합격이 아니다) — from이 "interface"·"package" 가운데 하나인 것, to가 "interface" 밖의 종류인 것(to가 "component"·"component_icon" 가운데 하나이고 from이 "class"·"abstract" 가운데 하나인 것은 빼고). 상속 등 다른 관계를 뜻했는지 확인하고, 뜻한 대로면 그대로 둔다.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full behavioral burden and does so extensively: it explains returned text, image, and input-file artifacts, image downscaling behavior, overwrite semantics, aggregated validation errors, failure versus warning classifications, and the iterative redraw workflow.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long, but it is front-loaded with purpose and organized into recognizable sections for results, errors, workflow, failure criteria, and layout tips. The length is largely justified by the complexity of diagram generation, though some procedural detail is repetitive and could be trimmed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the absence of annotations and an output schema, the description is complete enough for an agent to call the tool correctly: it covers inputs, outputs, error handling, the iteration loop, deployment-specific notation, and layout constraints. Nothing essential for correct invocation appears to be missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so parameter semantics are already heavily documented in the input schema. The description adds some conceptual context about left/top placement and via routing, but it mostly points the agent to per-argument descriptions rather than adding substantial meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: it draws a deployment diagram, saves a PNG and input file, and returns inspection results plus the image. It also explains what the diagram shows (components/artifacts on nodes) and how it differs from a generic drawing tool, so an agent can identify it without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear context for using this tool, including the deployment-diagram workflow, iteration until inspection passes, and when to use «deploy», nesting, communication paths, and «manifest». It does not explicitly name sibling diagram tools or state when not to use this tool, so it stops short of full alternative routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.