icebird1998/drawio-scientific-illustrator

Live MCP control of the visible draw.io canvas for step-by-step scientific illustration in Codex.

Draw.io Scientific Illustrator (레거시)

무엇인가요 – Codex 플러그인으로, AI 에이전트가 draw.io(diagrams.net으로도 알려짐) 데스크톱 버전 내에서 과학 다이어그램을 실시간으로 생성할 수 있게 해줍니다. 이 플러그인은 로컬 MCP(Multi-Channel Plugin) 서버를 통해 draw.io의 자체 그래프 모델 API를 호출하여, 에이전트가 형태, 레이블, 화살표를 추가하고 스타일을 적용하며 결과를 캔버스에서 즉시 확인할 수 있도록 합니다. OS 수준의 마우스/키보드 자동화나 XML 파일을 미리 생성하는 방식은 사용하지 않습니다.

왜 중요한가요 – 대규모 언어 모델 기반 에이전트(Codex)와 실시간 그래픽 에디터를 결합하는 구체적인 방법을 보여주며, 텍스트 프롬프트를 단계적으로 편집 가능한 벡터 기반 과학적 일러스트로 전환하는 과정을 가능하게 합니다.

핵심 구성 요소

구성 요소	역할
`drawio-live` MCP 서버	보이는 draw.io 창을 시작하거나 연결하고, 실시간으로 그래프 모델을 조작합니다(형태, 엣지 추가, 셀 업데이트, 스크린샷 촬영, 스냅샷 저장).
`drawio-file-utils` MCP 서버	저장된 `.drawio` 파일을 검증하고 PNG, SVG, PDF, JPG로 내보냅니다.
Codex 스킬	에이전트가 따르는 워크플로우를 인코딩합니다: 참조 이미지 검사, 기본 요소로 분해, 설정 가능한 속도로 그리기, 검토 및 개선, 최종 저장/내보내기.
로컬 Codex 마켓플레이스 항목	위 도구들을 패키지화하여 `codex plugin add` 명령어 하나로 설치할 수 있게 합니다.

요구 사항

Codex 데스크톱 앱 또는 플러그인 지원이 있는 CLI.
draw.io 데스크톱이 로컬에 설치되어 있어야 함 (Windows, macOS, Linux 지원).
Git.
Node.js (v22 이상): MCP 서버를 Codex의 번들러 런타임 외부에서 실행할 경우 필요합니다.

설치 (빠른 시작)

# Windows – 단일 줄 (install.ps1를 먼저 확인)
$p="$env:TEMP\drawio-scientific-install.ps1"; 
Invoke-WebRequest https://raw.githubusercontent.com/icebird1998/drawio-scientific-illustrator/main/install.ps1 -OutFile $p; 
powershell -ExecutionPolicy Bypass -File $p

# macOS / Linux – 단일 줄 (install.sh를 먼저 확인)
curl -fsSL https://raw.githubusercontent.com/icebird1998/drawio-scientific-illustrator/main/install.sh | bash

두 스크립트 모두 레거시 플러그인을 설치합니다. README에서는 활발한 개발을 위해 새로운 프로젝트 scientific-illustrator를 추천합니다.

수동 설치 (검증 가능)

git clone https://github.com/icebird1998/drawio-scientific-illustrator.git
cd drawio-scientific-illustrator
codex plugin marketplace add "$(pwd)"
codex plugin add drawio-scientific-illustrator@drawio-scientific-tools

(PowerShell에서는 $(pwd)를 (Get-Location).Path로 바꿔야 합니다.)

설치 후, Codex를 재시작하고 새 작업을 시작하여 스킬과 MCP 도구가 로드되도록 하세요.

일반적인 워크플로우

시작 – drawio_live_launch로 보이는 draw.io 창을 시작하거나 연결합니다.
준비 확인 – drawio_live_status로 그래프 모델이 준비되었는지 확인합니다.
그리기 – drawio_live_add_shape, drawio_live_add_edge, 또는 drawio_live_draw_sequence (속도 조절 가능)를 사용해 편집 가능한 기본 요소를 생성합니다.
검토 – drawio_live_screenshot으로 캔버스를 캡처하고, 에이전트가 이미지를 분석할 수 있도록 합니다.
개선 – drawio_live_inspect / drawio_live_update_cell로 레이블, 스타일, 위치를 수정합니다.
뷰 조정 – drawio_live_fit로 진화하는 다이어그램을 항상 화면에 보이게 합니다.
저장 – drawio_live_save_snapshot으로 실시간 그래프를 .drawio 파일에 저장합니다.
검증 및 내보내기 – drawio_validate와 drawio_export로 PNG, SVG, PDF, JPG를 생성합니다.

README에 추천되는 프롬프트(영어)가 제공되며, 동등한 중국어 버전도 지원됩니다.

설정 (선택적 환경 변수)

변수	의미	기본값
`DRAWIO_PATH`	draw.io 실행 파일의 명시적 경로.	자동 감지
`DRAWIO_LIVE_PORT`	MCP 서버의 선호하는 로컬 포트.	`9333` (또는 근처의 사용 가능한 포트)
`DRAWIO_LIVE_PROFILE`	라이브 인스턴스용 별도의 Electron 프로필 디렉터리.	`~/.drawio-live-mcp/<port>`

제한 사항 및 알려진 문제

레거시 – 더 이상 업데이트되지 않음. Windows v1.0.0만 공식적으로 테스트됨. macOS/Linux는 최선의 노력으로 작동함.
콘텐츠 범위 – 라이브 API는 편집 가능한 draw.io 기본 요소에 특화되어 있음. 고밀도 현미경 이미지, 히트맵, 복잡한 그래프는 향후 이미지 삽입 도구가 필요할 수 있음.
정확도 – 최종 시각적 품질은 참조 이미지의 해상도와 draw.io 형태로 그림을 얼마나 잘 표현할 수 있는지에 따라 달라짐.
포트 충돌 – DRAWIO_LIVE_PORT가 이미 사용 중이면 서버는 근처의 사용 가능한 포트를 선택함.

보안 및 개인정보

MCP 서버는 127.0.0.1에만 바인딩됨. 공개 엔드포인트를 노출하지 않음.
draw.io/diagrams.net 창에만 연결됨. 임의의 브라우저 탭에는 연결하지 않음.
텔레메트리나 클라우드 백엔드는 포함되지 않음.
사용자는 설치 스크립트를 검토하고 신뢰할 수 있는 리비전만 실행하도록 권장됨.

라이선스

참고: 이 리포지토리는 현재 활발히 유지 관리 중인 scientific-illustrator 로 이전되었으므로 아카이브됨입니다. 새 프로젝트에서는 이 레거시 버전 대신 해당 리포지토리를 사용하세요.