Local Draw.io MCP

Codex가 편집 가능한 draw.io XML 파일을 직접 생성하고 유지할 수 있게 해주는 로컬 STDIO MCP 서비스입니다.

도구

• server_info: 버전과 접근이 허용된 디렉터리를 확인합니다.

• create_diagram: 그룹, 노드 및 연결을 기반으로 .drawio 파일을 생성합니다.

• inspect_diagram: 첫 페이지의 노드, 연결 및 기하학 정보를 읽습니다.

• validate_diagram: 중복 ID, 잘못된 좌표, 범위 초과, 유효하지 않은 연결 및 노드 겹침을 검사합니다.

• update_diagram: 노드/연결선을 추가하거나 기존 노드를 수정합니다.

파일 속 텍스트는 데이터로만 처리되며 MCP 명령으로 실행되지 않습니다.

Related MCP server: Draw.io MCP Server

로컬 실행

npm install
npm test
npm start

npm start는 STDIO를 사용하며, 정상적으로 시작된 후에는 MCP 클라이언트 연결을 기다리므로 대화형 인터페이스가 표시되지 않습니다.

Codex 연동

Codex 데스크톱 버전에서 "설정 → MCP servers → Add server"를 열고 STDIO를 선택한 후 다음 항목을 작성합니다:

• Command: C:\Program Files\nodejs\node.exe

• Arguments: 이 프로젝트 폴더의 src\server.mjs 절대 경로

• Working directory: 이 프로젝트 디렉터리

config.example.toml의 내용을 ~/.codex/config.toml에 복사한 뒤 경로를 수정하고 Codex를 재시작해도 됩니다.

Codex CLI에서 다음을 실행할 수 있습니다:

codex mcp list

대화 입력창에서 /mcp를 사용해 연결 상태를 확인할 수 있습니다.

경로 제한

액세스 범위는 다음 환경 변수로 제어하며, Windows에서는 여러 디렉터리를 세미콜론으로 구분합니다:

• DRAWIO_MCP_READ_ROOTS

• DRAWIO_MCP_WRITE_ROOTS

미설정 시에는 이 MCP 프로젝트 디렉터리만 접근할 수 있습니다. 프로젝트 작업 영역만 열어두고 디스크 전체를 쓰기 가능으로 설정하지 않는 것이 좋습니다.

호출 및 예시

연결 후 Codex에 바로 지시할 수 있습니다:

drawio MCP를 사용하여 데이터 플랫폼 계층, 경보 엔진 계층 및 응답 피드백 계층이 포함된 主动预警系统.drawio 파일을 생성하고, 완료 후 validate_diagram을 실행하여 검증하세요.

생성 도구는 기본적으로 기존 파일을 덮어쓰지 않습니다. 덮어써야 하는 경우 반드시 overwrite=true를 명시적으로 전달해야 합니다.