⬡ VibeServe v1.0

The Agentic UI Coding Orchestrator for the Model Context Protocol

What is VibeServe?

VibeServe is a production-grade MCP server that turns natural language intent into fully-architected, accessible, production-ready UI code — through a 7-step agentic pipeline powered by your choice of LLM.

Drop it into Claude Desktop, Cursor, Windsurf, or any MCP-compatible client and start building.

The Vibe Pipeline

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

Each step is an independent MCP tool. Chain the full pipeline or call any step standalone.

Key Features

• 11 MCP Tools — Full pipeline from architecture to deployment

• 5 LLM Providers — OpenAI, DeepSeek, OpenRouter, Local (Ollama), OpenCode CLI — with automatic fallback

• MCP Sampling — Works with zero API keys via the client's own LLM

• WCAG AAA — Accessibility validation built into every generation step

• Multi-Agent Critique — UX Designer, Frontend Engineer, and Accessibility Advocate review in parallel

• SQLite Memory Store — Learns from high-scoring specs across sessions

• SHA-256 Cache — Tamper-resistant filesystem cache with TTL

• Prompt Injection Guard — _sanitize_input() strips injection patterns before every LLM call

• 43 Tests — 39 unit + 4 live DeepSeek integration tests, all passing

• Docker Support — Dockerfile + docker-compose.yml included

Quickstart

git clone https://github.com/ncsound919/AetherNexus-MCP
cd AetherNexus-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/AetherNexus-MCP/mcp_ui_optimizer_v4.py"]
    }
  }
}

Run tests:

pyproject.toml pytest test_aether_nexus.py test_integration_v5.py -v

All 11 MCP Tools

Architecture

See docs/index.html for the full interactive architecture page.

Quick overview:

MCP Client (Claude Desktop / Cursor / Windsurf)
       ↓ MCP Protocol
VibeServe FastMCP Server
  ├── 11 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 Providers

Donate

VibeServe is free and open source. If it saves you time:

💚 CashApp: $helptools

Every dollar helps keep the tools free.

License

MIT — see LICENSE

Built with 🖤 · VibeServe v1.0 · GitHub Pages