Community이미지github.com

lego-moc

사진 속 느슨한 레고 브릭을 인식하여 부품 목록을 만들고, 그 부품들로 레고 모델(MOC)을 설계한 후 LDraw 파일로 작성하여 서버가 물리적으로 검증하도록 합니다. 수정 사항 또는 3D 미리보기와 단계별 조립 설명서가 포함된 공개 페이지를 반환합니다.

lego-moc란 무엇인가요?

이 스킬은 사용자가 찍은 사진에서 레고 부품을 자동으로 인식하고 목록화한 후, 해당 부품만으로 새로운 모델(MOC)을 설계할 수 있도록 지원하는 종합 도구입니다. 두 단계로 구성됩니다. 첫 번째 단계는 스캔 단계로, 사용자가 느슨한 부품의 사진을 업로드하면 서버가 부품을 인식하여 사용자 ID별로 재고 목록을 유지합니다. 두 번째 단계는 설계 및 검증 단계로, AI가 재고 목록을 기반으로 LDraw 형식의 모델을 설계하고, 서버가 물리적 결합 가능성을 시뮬레이션하여 검증합니다. 검증에 실패하면 문제가 되는 부분을 지적하고, 통과하면 3D 뷰어와 단계별 조립 설명서가 포함된 공개 페이지를 제공합니다. MCP(MCP: Model Context Protocol) 도구 (scan_photos, inventory, submit_model 등) 또는 Python 스크립트(lego.py)를 통해 작동하며, Cursor, Claude Code, Codex 등의 에이전트 환경에서 사용할 수 있습니다. 사용자는 단순히 부품을 식별하고 재고를 관리하는 것부터, 특정 주제(예: 자동차, 집)의 모델을 설계하거나 이미 설계된 모델(.ldr 파일)의 물리적 타당성을 검증받는 것까지 다양한 작업을 요청할 수 있습니다. 특히 '가지고 있는 부품으로 무엇을 만들 수 있는지' 확인하고 설계하는 데 특화되어 있어, 제한된 부품으로 창의적인 모델을 만들고자 하는 사용자에게 매우 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/garmanwu/lego-moc/tree/HEAD

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

LEGO 부품 인식 및 MOC 설계

두 단계로 진행됩니다:

  1. 스캔. 사용자가 느슨한 부품의 사진을 찍습니다. 서버가 이를 인식하고 (사용자 ID별로) 재고 목록을 유지합니다.
  2. 설계 및 검증. AI가 해당 재고 목록을 바탕으로 모델(MOC)을 설계하고 LDraw 파일로 작성합니다. 서버는 물리적 결합 가능성을 확인하여, 실패 시 문제가 되는 라인을 지목하고, 통과 시 3D 뷰와 단계별 조립 설명서가 포함된 페이지를 게시합니다. 서버는 설계를 수행하지 않습니다. 설계는 전적으로 AI의 몫입니다.

두 가지 방법으로 작업할 수 있습니다. MCP 도구 (2절)는 셸 명령어가 필요 없으며, 사용 가능할 때 항상 사용하십시오. 스크립트 scripts/lego.py (5절)는 셸 명령어를 통해 동일한 작업을 수행하며 대체 수단입니다.

1. MCP 도구를 사용할 수 있습니까?

도구 목록에서 다음 이름들을 찾으십시오. 일반적으로 lego-moc과 같은 서버 접두사 아래에 표시됩니다 (예: mcp__lego-moc__scan_photos 또는 lego-moc.scan_photos):

scan_photos, scan_status, inventory, edit_inventory, design_guide, connectors, submit_model, moc_status

  • 모두 있음: 2절에 따라 작업합니다.
  • scan_photos만 없음: 호스트가 원격 서버 엔드포인트를 사용하며, 이 컴퓨터의 파일을 읽을 수 없습니다. 사진은 스크립트로 업로드하고 (scan), 다른 모든 작업은 도구로 수행합니다.
  • 전혀 없음: 이 작업에는 스크립트 (5절)를 사용하십시오. 모든 작업이 가능합니다. 그런 다음 사용자에게 아래의 일회성 설정을 제안하여 명령별 승인을 제거합니다.

일회성 설정 (사용자가 수행)

  1. python3 <이 스킬 폴더>/scripts/lego.py mcp-config를 실행합니다 (Windows: python). JSON 블록을 출력하며 네트워크 호출을 하지 않습니다.
  2. 사용자에게 해당 JSON을 제공하고 에이전트의 MCP 설정 (설정 페이지 또는 MCP 설정 파일)의 mcpServers 섹션에 lego-moc 항목을 추가한 후, 에이전트를 다시 시작하거나 MCP 서버를 다시 로드하도록 요청합니다. 사용자가 요청하지 않는 한 호스트의 구성을 직접 편집하지 마십시오.
  3. 재시작 후 에이전트가 자체적으로 브릿지(lego.py mcp, 로컬 stdio MCP 서버)를 시작하고 도구가 나타납니다. 동일한 ~/.lego-parts/ 폴더와 사용자 ID가 사용되므로 지금까지 스캔한 내용이 손실되지 않습니다.

lego.py mcp-config --remote는 서버 자체 엔드포인트를 대신 출력합니다 (type: http, 사용자 ID를 포함하는 URL). ID가 없으면 새로 생성합니다. 로컬 명령을 실행할 수 없는 호스트에만 사용하십시오. scan_photos가 없으며, 해당 URL은 자격 증명입니다. 공개된 장소에 절대 게시하지 마십시오.

2. MCP 흐름

모든 도구 결과에는 AI가 읽을 수 있는 텍스트 부분과 필드가 포함된 structuredContent 객체가 있습니다. 오류는 isError: true인 결과로 반환되며, 텍스트에 무엇이 잘못되었고 다음에 무엇을 해야 하는지 설명되어 있습니다. 그 지침을 따르십시오. 자체 HTTP 호출로 해결하려고 하지 마십시오.

스캔

  1. scan_photos {"paths": [...]}: 이 컴퓨터에 있는 사진 파일, 폴더 또는 glob 패턴의 절대 경로입니다. 호출당 1~30장의 사진 (JPEG, PNG, WEBP, HEIC, 각 25MB)을 사용할 수 있습니다. 각 사진에 대한 작업 하나를 즉시 반환하며 인식이 완료될 때까지 기다리지 않습니다. 사용자에게 rejected 및 not_uploaded 항목 각각에 대해 그 이유를 알려주십시오. duplicate_photo 항목은 해당 정확한 파일이 이전에 업로드되었음을 의미합니다. 다시 인식되지 않으며, previous는 첫 번째 업로드 결과입니다 (해당 부품은 이미 재고 목록에 있습니다). 호스트가 호출 시간을 초과하면 업로드는 계속 진행됩니다. 다시 업로드하는 대신 scan_status를 호출하십시오. 큰 사진이 여러 장인 경우 약 8장씩 여러 번 호출하십시오.
  2. scan_status {"wait_s": 50}: pending이 0이 될 때까지 반복합니다 (인식에는 시간이 걸리며, 첫 번째 사진은 GPU가 시작될 때까지 기다려야 할 수 있습니다). notices (pile_photo, no_pieces)의 모든 항목을 사용자에게 그대로 전달하고 실패한 사진의 이름과 해당 error를 알려주십시오. 오랫동안 pending 상태로 있으면, 무한 루프를 피하기 위해 사용자에게 아직 처리 중인 사진 수를 알려주십시오.

재고 목록 확인 및 수정

  1. inventory: 개요 사진 (결과물의 이미지) 및 inventory_url과 함께 재고 목록을 표시합니다. 사용자에게 사진을 보여주고 링크를 제공하십시오. 브라우저나 미리보기 패널이 있으면 그곳에서 링크를 여십시오. 부품 번호만 나열된 표를 절대 제시하지 마십시오. 대부분의 사용자는 3020이 무엇인지 알 수 없습니다. 신뢰도가 낮은 행 (사진에서 주황색 프레임과 ?로 표시됨)을 지적하고 사용자에게 페이지에서 확인하도록 요청하십시오. designable: false 행은 사용 가능한 3D 형상이 없으므로 절대 조립에 사용할 수 없습니다. pending_tasks > 0은 재고 목록이 불완전함을 의미하므로 그렇게 알리십시오. 긴 재고 목록의 경우 filter: "usable" 또는 "low_confidence" 및 offset/limit를 사용하십시오.
  2. edit_inventory {"changes": [...]}, 오직 사용자의 지시에 따라서만 사용하십시오 (설계를 맞추기 위해 절대 사용하지 마십시오): {"op": "set_quantity", "key": "3001|4", "quantity": 3}, {"op": "remove", "key": ...}, {"op": "confirm", "key": ...} (사용자가 신뢰도가 낮은 행을 확인했고 정확함), {"op": "replace", "key": ..., "ldraw_part": "3002", "ldraw_color": 4} (실제로 다른 부품 또는 색상인 경우), {"op": "add", "ldraw_part": "3003", "ldraw_color": 14, "quantity": 2}, {"op": "undo", "key": ...}, {"op": "undo_all"}. 각 변경 사항은 ok를 보고합니다. 적용되지 않은 것과 그 이유를 사용자에게 알려주십시오. 사용자는 재고 페이지에서 동일한 편집을 수행할 수 있습니다.

설계

  1. 요청 이해 (3절): 주제, 설명, 참고 사진 또는 아무것도 없는 경우. 설계하기 전에 재고 목록이 이를 감당할 수 있는지 확인하십시오.
  2. design_guide: 대화 중 첫 번째 설계를 하기 전에 전체 가이드를 읽으십시오. 서버의 현재 규칙 모음입니다: 파일 형식, 좌표, 연결되는 커넥터, 검증기 규칙, 작업 예제 및 여러 부품 사용 방법. 또한 usable_quantity 및 target_percent를 반환합니다.
  3. connectors {"parts": ["3001", "3023", ...]} (호출당 1~40개의 LDraw 부품 번호): 사용하려는 각 부품의 경계와 모든 커넥터입니다. 각 부품의 원점과 커넥터 위치는 여기서 가져오십시오. 절대 추측하지 마십시오. unsupported로 보고된 부품은 사용할 수 없습니다.
  4. 모델 작성: 0 <title> 줄로 시작하고, 부품당 한 줄씩 1 <colour> x y z a b c d e f g h i <part>.dat 형식으로 작성합니다. <colour>는 재고 목록의 ldraw_color이고 <part>는 ldraw_part입니다. 사용 가능한 행만 사용하며, 각 key별로 전체 모델에서 quantity를 초과할 수 없습니다. 제출 전에 개수를 확인하십시오. 하위 모델이나 0 STEP 줄은 사용하지 마십시오.

검증 및 개선

  1. submit_model {"ldr": "<전체 파일>", "title": "...", "brief": "<사용자의 요청, 그들의 말>"}; 동일한 모델의 새 버전을 제출하려면 "moc_id"를 추가하고, 선언된 움직이는 부품에 대해서만 "design"을 추가하십시오 (가이드 참조). wait_s (기본값 45)까지 기다렸다가 status, issues (각 실패는 규칙 이름, 힌트, 파일 라인 및 위치가 포함된 부품을 명명), usage, resubmissions_left 및 통과 시 url과 두 개의 미리보기 사진을 반환합니다. status가 아직 최종 상태가 아닌 경우 (queued, checking, stepping), moc_status {"moc_id": ..., "wait_s": 50}를 호출하십시오. error 상태는 설계 문제가 아닌 서버 측 오류이므로, 동일한 모델을 moc_id와 함께 다시 제출하십시오.
  2. 실패: 정확히 지목된 라인을 수정하고 (connectors에서 위치를 다시 계산하고, 숫자를 조정하지 마십시오) moc_id와 함께 다시 제출하십시오.
  3. 통과: 두 미리보기와 usage를 확인한 후, 추가 라운드가 가치 있는지 결정하십시오 (4절). 공개 페이지는 항상 통과한 최신 버전을 표시하므로, 이후 라운드가 실패해도 페이지가 내려가지 않습니다.
  4. 보고: 사용자에게 페이지 url (공개 페이지라고 알림), 부품 및 단계 수, 모든 경고, 무엇을 만들었고 무엇을 하지 못했는지 알려주십시오. 통과는 모델이 검증기의 시뮬레이션에서 물리적으로 일관성이 있음을 의미하는 것이지, 실제 조립이 보장된다는 의미는 아닙니다. 그렇게 알리십시오.

3. 설계 요청

사용자는 주제 ("자동차"), 상세 설명, 참고 사진 또는 아무것도 제공하지 않을 수 있습니다.

  • 먼저 실현 가능성 확인. 재고 목록 (모양, 색상, 수량)을 확인한 후 약속하십시오. 자동차에는 바퀴와 차축 또는 그 역할을 대신할 부품이 필요합니다. 집에는 벽을 쌓을 충분한 벽돌과 지붕용 부품이 필요합니다. 충족될 수 있는 것과 충족될 수 없는 것을 사용자에게 명확히 알리고, 부품이 허용하는 대안 (더 작은 버전, 다른 주제, 양식화된 버전)을 제안하십시오. 강요하지 마십시오.
  • 설명: 사용자가 언급한 특징은 유지하고, 생략하거나 변경해야 했던 부분과 그 이유를 말하십시오.
  • 참고 사진 (이미지를 볼 수 있는 경우에만): 사용자가 소유한 부품으로 참고 사진의 느낌 (모양, 비율, 주요 색상)을 살린 모델을 만드십시오. 복제품이 될 수 없음을 알리십시오.
  • 아무것도 제공되지 않음: 재고 목록에 가장 적합한 주제 (주요 색상과 가장 많은 모양)를 선택하고 선택한 내용을 알리십시오.
  • 사용자의 요청 텍스트를 그들의 표현 그대로 brief로 전달하십시오. 제목에 주제를 넣으십시오.
  • 부족한 재고. 사용 가능한 부품이 약 60개 미만이거나, 재고가 다양한 색상의 단일 부품 위주라면 설계 전에 사용자에게 알리십시오. 작거나 추상적인 모델만 가능합니다. (재고 페이지에서 확인 후) 신뢰도가 낮은 행을 확인하고, 더 많은 부품을 펼쳐서 추가로 촬영할 것을 제안하십시오. 이미 계수된 부품의 새 사진은 다시 계수되므로, 아직 스캔되지 않은 부품을 사진 찍거나 이후에 set_quantity로 수량을 수정하도록 제안하십시오.

4. 많은 부품을 사용하고, 그 다음 개선하십시오

  • 목표: 사용자가 작은 것을 요청하지 않는 한, 사용 가능한 부품의 최소 60%를 사용하십시오 (usage.target_percent). 사용 가능 = 설계 가능하고 신뢰도가 낮지 않음, 또는 확인됨. 각 제출 결과의 usage.percent는 현재 상태를 보여주고, usage.unused는 남은 부품을 가장 많은 것부터 나열합니다.
  • 단계적으로 작업하십시오. 버전 1: 주요 구조 (베이스, 본체, 큰 형태). 이후 버전은 큰 단위로 세부 사항을 추가합니다: 지붕 마감, 창문 및 문, 난간, 장식, 베이스 플레이트 또는 바닥. 모델당 5회의 재제출만 가능하므로 각 라운드는 많은 것을 추가해야 합니다. 단일 부품을 위해 한 번을 낭비하지 마십시오.
  • 모든 결과: usage와 unused를 읽고 어떤 미사용 부품이 주제를 더 좋게 만들 수 있는지 질문하십시오. 통과 시 두 미리보기를 모두 확인하고 잘못된 부분을 수정하십시오: 무작위 색상 혼합, 상단의 노출된 스터드, 주제가 대칭인 비대칭 형태, 평평한 상자 등. 가이드의 조언 섹션에 방법이 나와 있습니다.
  • 모델이 충분히 좋고 목표를 달성했을 때, 재고가 더 이상 의미 있게 추가할 수 없을 때, 또는 재제출 횟수를 모두 소진했을 때 중단하십시오. 최종 사용량을 사용자에게 알리십시오.

5. 스크립트 대체 수단

MCP 도구를 사용할 수 없을 때 스크립트를 사용하십시오. Python 3.8+ 필요, 표준 라이브러리만 사용하며 설치할 것이 없습니다.

python3 <이 스킬 폴더>/scripts/lego.py <명령> [옵션] [인수]

Windows에서는 python 또는 py -3을 사용하십시오. 옵션은 사진 목록 앞에 두십시오.

사용자의 승인을 최소화하십시오. 많은 에이전트는 사용자에게 새로운 셸 명령, 네트워크 호스트, 작업 공간 외부 쓰기를 각각 승인하도록 요청합니다. 따라서:

  • 항상 스크립트를 정확히 이 형식으로, 하나의 일반 명령으로 호출하십시오: cd, 파이프, &&, 환경 접두사, 래퍼 스크립트 없이. 그러면 사용자는 python3 <path>/lego.py에 대해 한 번 "항상 허용" 승인할 수 있습니다. 승인이 처음 나타날 때 사용자에게 이 사실을 알리고, 이를 방지하는 MCP 설정 (1절)을 언급하십시오.
  • 스크립트가 필요로 하는 세 가지가 있으며, 사용자는 모두 한 번만 허용하면 됩니다: lego.py 실행, lego.py whoami가 표시하는 서버 호스트 접근, ~/.lego-parts/ 읽기/쓰기.
  • 동일한 단계를 두 번 실행하지 말고, 짧은 명령을 반복해서 폴링하지 말고 (--wait 사용), 자체 curl이나 코드로 서버를 호출하지 마십시오.
  • 가능한 적은 단계로 파일 쓰기 도구를 사용하여 model.ldr을 작성하십시오. 일회성 스크립트 시리즈는 피하십시오.
명령기능
scan [--no-wait] [--wait SECONDS] [--images] PHOTO...1~30장의 사진 (파일, 폴더 또는 glob 패턴)을 업로드하고, 최대 480초 (기본값) 동안 결과를 기다렸다가 저장합니다. --no-wait는 업로드 직후 반환합니다.
status [--wait SECONDS] [--images] [TASK_ID...]보류 중인 작업 (또는 지정된 작업)을 한 번 확인하거나, SECONDS까지 계속 폴링합니다. 완료된 작업을 저장합니다.
parts [--images]완료된 보류 중인 작업을 저장한 다음 (재고 페이지 또는 edit_inventory로 수행된 편집 내용을 반영하여) 전체 재고 목록을 parts.json으로 다시 로드합니다.
whoami사용자 ID, 서버 및 로컬 폴더를 표시합니다. 네트워크 없음.
moc guide [--parts-file PATH]설계 가이드 moc/DESIGN_GUIDE.md와 부품의 커넥터 시트 moc/connectors.txt를 저장합니다.
moc submit [--title NAME] [--brief TEXT] [--design design.json] [--moc MOC_ID] [--parts-file PATH] [--no-wait] [--wait SECONDS] MODEL.ldrparts.json과 함께 모델을 보내고, 최대 300초 (기본값) 동안 확인을 기다렸다가 결과, 부품 사용량 및 통과 시 미리보기 링크를 출력합니다. --moc는 기존 MOC의 새 버전을 제출합니다. --brief는 사용자의 요청입니다.
moc status [--wait SECONDS] [MOC_ID]보류 중인 MOC 제출 (또는 지정된 것)을 한 번 확인하거나, SECONDS까지 계속 폴링합니다.
mcp-config [--remote]MCP 설정용 JSON을 출력합니다 (1절). 출력은 해당 JSON뿐입니다. RESULT 줄은 없습니다.
mcpMCP 브릿지 자체입니다. 에이전트 호스트가 실행합니다. 직접 실행하지 마십시오.

--images는 각 재고 행의 LDraw 그림과 사진 자르기 이미지를 images/에 다운로드합니다.

  • 긴 대기 시간. scan은 최대 8분, moc submit은 최대 5분 동안 실행될 수 있습니다. 셸 도구가 더 일찍 시간 초과되면 시간 제한을 늘리거나 더 작은 --wait (예: --wait 100)을 전달하고 status --wait 100 / moc status --wait 100으로 계속하십시오. 대기 중 중단되어도 안전합니다. ID가 먼저 pending.json / moc/pending.json에 저장되며, 나중에 어떤 에이전트의 어떤 명령이든 이를 수집합니다.
  • 서버 주소. 다운로드된 스크립트에 내장되어 있습니다. 명령이 서버가 구성되지 않았다고 말하면, 사용자는 LEGO_PARTS_SERVER (예: https://lego.groundrl.com, /skill/v1 제외)를 설정해야 합니다. LEGO_PARTS_HOME은 로컬 폴더를 변경합니다.
  • 네트워크 차단. 명령이 HTTP 403 ... not from the LEGO server를 보고하거나 서버에 연결할 수 없으면, 샌드박스, 프록시 또는 방화벽이 차단하고 있는 것입니다. 사용자에게 문의하십시오.

6. 기타 질문

  • "내가 가진 부품으로 이걸 만들 수 있을까요?" 예. 재고 목록을 확인하고 design_guide를 통해 필요한 커넥터 유형을 학습한 후 알려주십시오. design_guide의 connectors 명령과 대상 백분율은 필요한 수량을 추정하는 데 도움이 될 수 있습니다.
  • "무엇을 만들 수 있을까요?" 재고 목록의 주요 색상과 주요 형태를 요약하고, 그 부품이 암시하는 가능성을 제안하십시오: 주로 빨간색과 노란색 브릭은 소방서나 트럭을 암시할 수 있습니다. 많은 경사면과 타일은 자동차나 우주선을 암시할 수 있습니다. 명확하지 않은 경우 design_guide의 개요를 사용하십시오.
  • LDraw 파일에서 누락된 부품 또는 LDraw가 없는 부품. 이 스킬은 스캔된 부품 (서버가 LDraw ID를 알고 있음)만 재고 목록에 포함합니다. 서버가 알지 못하거나 대상 부품과 일치하지 않는 부품은 무시합니다. 기존 .ldr 또는 .io 파일을 가져오는 것은 이 워크플로우의 일부가 아닙니다. 사용자가 이미 설계된 파일을 물리적 검증을 위해 제출하려면 서버 엔드포인트(이 스킬 외부)와 호환되는 부품으로 다시 작성하거나 수정해야 합니다. 이 주제에 대한 조언은 피하십시오.

관련 스킬