inkscape-mcp

stdio 기반의 로컬 MCP 서버로, 제한된 방식으로 Inkscape를 헤드리스로 제어합니다. 이 사전 알파 버전은 SVG/Inkscape 문서, 크기, 페이지 및 PNG, PDF, SVG로의 검증된 내보내기에 중점을 둡니다.

현재 작동하는 기능

• Windows MSIX 패키지를 포함한 Inkscape 검색 및 기능 증거가 포함된 --doctor.

• 안전한 상대 경로, SHA-256 검토, 잠금, 백업 및 원자적 커밋이 있는 승인된 워크스페이스.

• page_only 의미론, 사용자 정의 측정 또는 A3/A4/Letter 사전 설정 및 초기 페이지를 사용하여 SVG 문서 생성, 검사 및 크기 조정.

• Inkscape 1.4의 명시적 페이지: 안정적인 ID로 나열, 추가, 업데이트, 삭제 및 재정렬.

• 페이지의 유형화된 설정: 페이지 색상/불투명도, 데스크톱 색상 및 테두리 색상/불투명도.

• 기본 SVG 사전 점검 및 PNG, PDF 1.4/1.5 및 평면 또는 Inkscape SVG 내보내기. 결과는 게시 전에 검증됩니다.

아직 완전한 벡터 편집기는 아닙니다. 일반 객체 조작, 레이어, 텍스트, 경로, 선택, 필터 또는 로컬 종속성을 지원하지 않습니다. 범위 및 남은 작업은 마스터 플랜을 참조하세요.

Related MCP server: SVG Maker MCP Server

요구 사항

• Node.js 24.x 및 npm 11.x.

• Inkscape 1.4.4 또는 호환 버전. Windows에서는 개발 중 관찰된 MSIX 설치가 자동으로 감지됩니다.

로컬에서 실행

npm ci
npm run check
npm run test:mcp
node dist/cli.js --doctor --json
node dist/cli.js --workspace-root C:\ruta\a\tus\disenos

마지막 명령은 MCP 프로토콜을 stdout에서만 유지합니다. MCP 클라이언트가 node, 인수 dist/cli.js 및 하나 이상의 --workspace-root 인수로 시작하도록 구성하세요. 해당 디렉터리만 문서 도구에 표시됩니다.

현재 MCP 도구

변경 및 내보내기는 expectedRevision을 요구합니다. 파일이 읽기와 커밋 사이에 변경되면 다른 개정을 덮어쓰는 대신 작업이 실패합니다. 모든 내보내기는 Inkscape에 스테이징의 검증된 SVG 사본을 제공하며, 워크스페이스의 활성 경로는 절대 제공하지 않습니다.

보안 및 상태

이 프로젝트는 네이티브 파서의 알려지지 않은 취약점을 격리한다고 약속하지 않습니다. 경로, XML, 인수, 프로세스, 크기 및 덮어쓰기를 제한합니다. 현재 네이티브 입력 정책은 trusted-local-only입니다. 내보내기는 Inkscape를 시작하기 전에 활성 콘텐츠 또는 원격 리소스가 있는 SVG를 거부합니다. 크기 조정 변경도 동일한 규칙을 적용합니다.

기여 지침 및 불변 조건은 AGENTS.md에 있습니다. 패키지는 계속 비공개입니다. npm 또는 레지스트리에 게시하려면 별도의 명시적 승인이 필요합니다.

라이선스

MIT Copyright 2026 Berrio.