VibeServe v1.0

Model Context Protocol을 위한 에이전트 기반 UI 코딩 오케스트레이터

VibeServe란 무엇인가요?

VibeServe는 자연어 의도를 7단계 에이전트 파이프라인을 통해 완벽하게 설계되고 접근성이 보장된 프로덕션급 UI 코드로 변환하는 프로덕션 수준의 MCP 서버입니다. 원하는 LLM을 선택하여 사용할 수 있습니다.

Claude Desktop, Cursor, Windsurf 또는 MCP 호환 클라이언트에 추가하여 바로 개발을 시작하세요.

Vibe 파이프라인

🏗️ vibe_architect → 💻 vibe_code → 🔍 vibe_review → ✅ vibe_verify → 🔄 vibe_iterate → 🧪 vibe_test → 🚀 vibe_deploy

각 단계는 독립적인 MCP 도구입니다. 전체 파이프라인을 연결하거나 각 단계를 개별적으로 호출할 수 있습니다.

주요 기능

• 13개의 MCP 도구 — 아키텍처부터 배포까지 전체 파이프라인 지원

• 5개의 LLM 제공자 — OpenAI, DeepSeek, OpenRouter, Local (Ollama), OpenCode CLI — 자동 폴백 지원

• MCP 샘플링 — 클라이언트 자체 LLM을 사용하여 API 키 없이 작동

• WCAG AAA — 모든 생성 단계에 접근성 검증 내장

• 멀티 에이전트 검토 — UX 디자이너, 프론트엔드 엔지니어, 접근성 전문가가 병렬로 검토

• SQLite 메모리 저장소 — 세션 전반에 걸쳐 높은 점수의 사양으로부터 학습

• SHA-256 캐시 — TTL이 포함된 변조 방지 파일 시스템 캐시

• 프롬프트 인젝션 방지 — 모든 LLM 호출 전 _sanitize_input()을 통해 인젝션 패턴 제거

• 43개의 테스트 — 39개의 단위 테스트 + 4개의 실시간 DeepSeek 통합 테스트 모두 통과

퀵스타트

git clone https://github.com/ncsound919/VibeServe-MCP
cd VibeServe-MCP
pip install -e ".[dev]"
cp .env.example .env  # add your API keys, or leave blank for local/sampling

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "vibeserve": {
      "command": "python",
      "args": ["/path/to/VibeServe-MCP/vibeserve.py"]
    }
  }
}


**Run tests:**
```bash
pyproject.toml pytest test_aether_nexus.py test_integration_v5.py test_integration_real_api.py -v

13개의 모든 MCP 도구

아키텍처

전체 대화형 아키텍처 페이지는 **docs/index.html**에서 확인하세요.

빠른 개요:

MCP Client (Claude Desktop / Cursor / Windsurf)
       ↓ MCP Protocol
VibeServe FastMCP Server
  ├── 13 Tools · 5 Resources · 6 Prompts · SamplingProvider
  ├── V5 Agentic Pipeline (Architect → Implement → Review → Verify → Iterate → Test → Deploy)
  ├── LLMRouter (OpenAI · DeepSeek · OpenRouter · Local · OpenCode + auto-fallback)
  ├── MemoryStore (SQLite, indexed by page_type + score)
  ├── CacheManager (SHA-256 integrity + TTL)
  └── SchemaValidator (UISchema v1.0 + WCAG AAA)

LLM 제공자

후원

VibeServe는 무료 오픈 소스입니다. 시간을 절약해 주었다면 후원해 주세요:

💚 CashApp: $helptools

모든 후원금은 도구를 무료로 유지하는 데 도움이 됩니다.

라이선스

MIT — LICENSE 참조

Built with 🖤 · VibeServe v1.0 · GitHub Pages