d2-mcp

D2 다이어그램 언어를 위한 MCP 서버입니다. MCP 호환 AI 어시스턴트에서 D2 다이어그램을 컴파일, 검증 및 탐색하세요.

네이티브 D2 CLI 바이너리(Docker 이미지에 자동 설치됨)를 사용하여 다이어그램을 SVG 및 PNG로 컴파일합니다.

도구

리소스

로컬 개발

사전 요구 사항

• Node.js 22+

• D2 CLI — d2lang.com에서 설치하거나 D2_PATH 환경 변수를 바이너리 위치로 설정하세요.

• 아이콘 (선택 사항) — scripts/download-icons.sh ./icons를 실행한 다음 ICONS_DIR=./icons를 설정하여 로컬 아이콘 확인을 활성화하세요. 이 설정이 없으면 아이콘 URL이 D2 CLI로 그대로 전달됩니다.

npm install
npm run build
npm start

자동 재시작을 포함한 개발 환경:

npm run dev

서버는 기본적으로 3000번 포트에서 시작됩니다(PORT 환경 변수로 재정의 가능).

• 상태 확인: GET /health

• MCP 엔드포인트: POST /mcp (스트리밍 가능한 HTTP 전송)

환경 변수

배포 (Render)

이 프로젝트에는 Render에 원클릭으로 배포할 수 있는 Dockerfile 및 render.yaml 블루프린트가 포함되어 있습니다. Docker 이미지는 빌드 시점에 D2 CLI 바이너리를 자동으로 설치하고 모든 아이콘을 다운로드합니다.

1. 이 저장소를 GitHub에 푸시합니다.

2. Render에서 새로운 Blueprint를 생성하고 저장소를 연결합니다.

3. Render가 자동으로 render.yaml을 감지하고 배포합니다.

또는 다음 설정으로 Web Service를 수동으로 생성하세요:

• 환경: Docker

• 상태 확인 경로: /health

• 플랜: Free

MCP 서버 연결

배포가 완료되면 스트리밍 가능한 HTTP를 통해 연결되도록 MCP 클라이언트를 구성하세요:

{
  "mcpServers": {
    "d2": {
      "url": "https://your-service.onrender.com/mcp"
    }
  }
}

URL을 실제 Render 서비스 URL(로컬의 경우 http://localhost:3000/mcp)로 바꾸세요.

컴파일 도구 옵션

라이선스

MIT