vaults-diagram-tools

SVG/JPEG 렌더링, 오프라인 에셋 및 MCP 워크플로우를 위한 휴대용 Mermaid 및 소스 코드 다이어그램 툴킷입니다.

포함된 기능

• Vaults 툴체인에서 추출한 Mermaid 렌더러.

• 소스 코드에서 Mermaid 다이어그램으로 변환하는 생성기.

• 3개의 명시적 도구를 포함한 MCP stdio 서버.

• zip 및 컨테이너 배포를 위한 오프라인 지원 릴리스 에셋.

• Homebrew, deb/rpm, VS Code, CDN, Docker 및 Podman을 위한 패키징 템플릿.

포함되지 않은 기능: OCR/문서 변환, Claro 볼트 감사, CPQ 가져오기, 클리핑 또는 Casa Conectada PDF 도구.

설치

GitHub에서 npm 패키지 설치

npm install github:malnati/vaults-diagram-tools

로컬 체크아웃

git clone https://github.com/malnati/vaults-diagram-tools.git
cd vaults-diagram-tools
npm ci
npm test

컨테이너

docker build -f containers/Containerfile -t vaults-diagram-tools:local .
podman build -f containers/Containerfile -t vaults-diagram-tools:local .

릴리스 이미지는 ghcr.io/malnati/vaults-diagram-tools로 GitHub 컨테이너 레지스트리에 게시됩니다.

명령줄 사용법

vaults-mermaid-render path/to/diagram.mmd --output-dir out --png --ascii --manifest out/manifest.json
vaults-source-diagrams --source-dir src --output-dir diagrams --langs auto --diagrams dependency,class
vaults-diagram-mcp

로컬 체크아웃 대응 명령어:

node packages/renderer/render-mermaid-assets.mjs examples/simple/flowchart.mmd --output-dir /tmp/vaults-diagram-tools
node packages/source-diagrams/source-diagrams.mjs --source-dir packages/source-diagrams/tests/fixtures/js-project --output-dir /tmp/source-diagrams
node packages/mcp/server.mjs

지원되는 공개 CLI는 위의 세 가지 명령입니다. 추가적인 패키지 바이너리는 이전 Vaults 경로와의 호환성을 위한 진입점이며 향후 메이저 릴리스에서 폐기될 수 있습니다.

MCP 도구

vaults-diagram-mcp는 정확히 세 가지 도구를 제공합니다:

• render_mermaid_text

• render_mermaid_file

• generate_source_diagrams

마크다운 다이어그램 정책

생성된 마크다운은 아티팩트를 링크하고 mermaid 펜스 블록에 소스를 표시해야 합니다:

#### Diagram title
- Links: [Mermaid source](assets/diagram.mmd) / [SVG](assets/diagram.svg) / [JPEG](assets/diagram.jpg)

```mermaid
flowchart TD
  A --> B
```

SVG 및 JPEG 파일은 전달 아티팩트입니다. 마크다운은 이를 이미지로 직접 삽입하는 대신 링크해야 합니다.

오프라인 벤더 런타임

소스 트리에는 node_modules가 커밋되지 않습니다. 빌드 및 릴리스 작업은 다음을 통해 오프라인 벤더 에셋을 생성합니다:

npm run vendor:refresh
npm run test:vendor:offline

렌더러는 개발 중에는 일반 npm 의존성에서 실행되거나, MMDC_VENDOR_ONLY=1일 때 packages/renderer/vendor/node에서 실행될 수 있습니다.

배포 상태

v1에서 작동하는 기능:

• npm 패키지 메타데이터 및 GitHub 설치 흐름

• Docker/Podman 이미지

• MCP 서버

• zip 릴리스

• GitHub Actions CI, 릴리스, CodeQL 및 Pages 워크플로우

v1 템플릿:

• Homebrew 공식

• nfpm을 통한 deb/rpm

• VS Code 확장 셸

• npm 게시가 활성화되면 npm/jsDelivr/unpkg를 통한 CDN 파사드

문서

• GitHub Pages 문서

• Vaults 호환성 노트

• 기여 가이드

• 보안 정책