VULK MCP Server

기능 소개

이 MCP 서버는 AI 코딩 어시스턴트를 VULK의 풀 애플리케이션 플랫폼에 연결합니다. *"프로젝트 관리 대시보드 만들어줘"*라고 말하면 템플릿이나 스캐폴딩이 아닌, 실제 AI 생성을 통해 완성된 애플리케이션이 구축됩니다.

생성

• 16개 이상의 LLM 모델 — Claude Opus 4.6, GPT-5.4, Gemini 3.1 Pro, DeepSeek V3, Grok 4 등

• 풀스택 출력 — React + Tailwind + 라우팅 + API 엔드포인트 + 데이터베이스 스키마

• 실시간 스트리밍 — 터미널에서 파일이 생성되는 과정을 확인

• 자동 수정 파이프라인 — 린팅, 브라우저 검증, 자체 디버깅 루프

내보내기 및 배포

• 웹 — 사용자 지정 도메인 + SSL을 사용하여 Cloudflare Pages에 배포

• PWA — 오프라인 지원이 포함된 프로그레시브 웹 앱

• APK — Android 앱 빌드 (서버 측 컴파일)

• iOS — Flutter를 통한 iOS 앱 빌드

• Flutter — 네이티브 모바일을 위한 웹-to-Flutter AI 변환기

• 사용자 지정 도메인 — 자동 SSL, DNS 구성 포함

플랫폼

• BYOM (Bring Your Own Model) — 모든 공급자의 API 키 사용 가능

• Figma 가져오기 — Figma 디자인을 코드로 변환

• GitHub 통합 — 생성된 코드를 직접 푸시

• 팀 협업 — 공유 작업 공간, 역할 기반 권한

• 8개 언어 — EN, PT, FR, DE, ES, IT, JA, HI

빠른 설정

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "vulk": {
      "command": "npx",
      "args": ["-y", "vulk-mcp-server"],
      "env": {
        "VULK_API_KEY": "vk_sk_your_key_here"
      }
    }
  }
}

Cursor

설정 → MCP 서버 → 추가:

{
  "vulk": {
    "command": "npx",
    "args": ["-y", "vulk-mcp-server"],
    "env": {
      "VULK_API_KEY": "vk_sk_your_key_here"
    }
  }
}

VS Code (GitHub Copilot)

.vscode/mcp.json 생성:

{
  "servers": {
    "vulk": {
      "command": "npx",
      "args": ["-y", "vulk-mcp-server"],
      "env": {
        "VULK_API_KEY": "vk_sk_your_key_here"
      }
    }
  }
}

Windsurf

MCP 설정에 추가:

{
  "vulk": {
    "command": "npx",
    "args": ["-y", "vulk-mcp-server"],
    "env": {
      "VULK_API_KEY": "vk_sk_your_key_here"
    }
  }
}

Gemini CLI

GitHub에서 직접 확장 프로그램을 설치하세요:

gemini extensions install VULK-dev/vulk-mcp-server

그런 다음 API 키를 설정하세요:

export VULK_API_KEY="vk_sk_your_key_here"

또는 메시지가 표시될 때 확장 프로그램 설정에서 구성하세요. 이 확장 프로그램은 내부적으로 동일한 MCP 서버를 사용하여 Gemini CLI에서 직접 모든 VULK 도구(생성, 편집, 배포 등)에 액세스할 수 있게 합니다.

API 키 받기

1. vulk.dev/settings/api-keys로 이동

2. Create API Key 클릭

3. 키 복사 (vk_sk_로 시작)

무료 계정은 월 3회 생성이 가능합니다. 더 많은 사용을 원하시면 업그레이드하세요.

도구

generate — 새 앱 빌드

"사용자 인증, 분석 차트, 팀 관리 및 다크 모드가 포함된 최신 SaaS 대시보드 빌드"

프로젝트를 생성하고 AI 생성을 트리거하며, 라이브 미리보기 URL과 함께 생성된 모든 파일을 반환합니다. 생성은 의도 분석, 다중 파일 코드 생성, 자동 수정, 브라우저 검증 및 품질 점수 산정 등 VULK의 전체 파이프라인을 거칩니다.

edit — 기존 프로젝트 수정

"프로필, 결제, 알림 탭이 있는 설정 페이지 추가"

기존 프로젝트 파일의 전체 컨텍스트와 함께 귀하의 지시 사항을 VULK의 AI로 보냅니다. AI가 생성하거나 수정할 파일을 결정합니다.

list — 프로젝트 목록 확인

ID, 프롬프트, 날짜 및 배포 URL이 포함된 모든 VULK 프로젝트를 반환합니다.

get — 프로젝트 세부 정보

특정 프로젝트의 상태, 메타데이터 및 URL을 가져옵니다.

files — 소스 코드 읽기

프로젝트의 모든 파일(경로, 콘텐츠, 언어 감지)을 다운로드합니다.

deploy — 프로덕션 배포

Cloudflare Pages에 배포하고 사용자 지정 도메인 지원이 포함된 라이브 프로덕션 URL을 받습니다.

models — 사용 가능한 LLM 모델

플랜에서 사용 가능한 모든 모델(Claude Opus 4.6, Sonnet 4.6, GPT-5.4, Gemini 3.1 Pro, DeepSeek V3, Grok 4 등)을 나열합니다.

usage — 사용량 확인

API 요청 횟수, 남은 크레딧 및 속도 제한 상태를 확인합니다.

subscribe — 플랜 업그레이드

업그레이드를 위한 결제 링크를 받습니다. 플랜은 월 $19.99에서 $299까지 다양합니다.

환경 변수

작동 원리

You → "Build me a task manager"
       ↓
MCP Server → POST /api/v1/projects (create record)
       ↓
MCP Server → POST /api/agent/stream (trigger AI generation)
       ↓
VULK Agent → Intent analysis → Code generation → Auto-fix → Browser verify
       ↓
MCP Server ← SSE stream (file_start, file_delta, file_complete events)
       ↓
You ← { files: [...], previewUrl, editorUrl }

생성 파이프라인 포함 항목:

• 의도 분석 — 원하는 앱의 종류를 이해

• ReAct 에이전트 루프 — 도구 사용을 통해 파일 계획 및 생성

• 자동 수정기 — 결정론적 코드 수정 (임포트, 라우팅, 스타일링)

• 브라우저 검증 — 앱을 렌더링하고 오류를 포착하며 자체 복구

• 품질 점수 산정 — 출력이 프로덕션 표준을 충족하는지 확인

가격

크레딧은 토큰 기반입니다. 간단한 앱은 약 100 크레딧, 복잡한 앱은 약 500+ 크레딧이 소모됩니다. 전체 가격 세부 정보.

개발

git clone https://github.com/vulkdev/vulk-mcp-server.git
cd vulk-mcp-server
npm install
npm run build
VULK_API_KEY=vk_sk_... node dist/index.js

링크

• VULK — AI 기반 애플리케이션 빌더

• API 키 — 키 받기

• 가격 — 플랜 및 가격

• 문서 — 전체 문서

• 비교 — VULK vs Bolt vs Lovable vs v0

라이선스

MIT