freelife1191/vibe-starter-kit-mcp

vibe-starter-kit-mcp

MCP server for vibekit - AI Agent templates and reference library

📋 Overview

vibe-starter-kit-mcp is an MCP (Model Context Protocol) server that provides:

• 270+ Reference Documents: Comprehensive technical documentation (Next.js, Supabase, AWS, etc.)
• 42 Template Checklists: Structured development templates across 3 tiers (Free, Pro, Max)
• AI Agent Support: Optimized for Claude Code, Cursor, and other AI development tools
• Real-time Development: Fast feedback loop with tsx watch and npm link

🏗️ Architecture

This project uses Git Submodule architecture:

vibe-starter-kit-mcp/
├── src/                    # MCP server source code
├── data/                   # Git Submodule → vibe-starter-kit
│   └── data/              # Actual vibekit data
│       ├── templates/     # 42 checklists (3 tiers)
│       ├── reference/     # 270+ documents
│       └── guides/        # User guides
├── scripts/               # Automation scripts
└── test-workspace/        # Test environments

🚀 Quick Start

Prerequisites

• Node.js 20+
• pnpm, npm, or yarn
• Git

Installation

# Clone with submodules
git clone --recursive https://github.com/freelife1191/vibe-starter-kit-mcp.git
cd vibe-starter-kit-mcp

# Run setup script
./scripts/dev-setup.sh

The setup script will:

1. Initialize Git Submodules
2. Install dependencies
3. Build TypeScript
4. Set up npm link
5. Create test workspace

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vibekit-dev": {
      "command": "node",
      "args": ["/absolute/path/to/vibe-starter-kit-mcp/dist/index.js"],
      "env": {
        "VIBEKIT_DATA_PATH": "/absolute/path/to/vibe-starter-kit-mcp/data/data",
        "DEBUG": "true",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

Replace /absolute/path/to/ with your actual path.

Development

# Terminal 1: Start development server (auto-rebuild on changes)
pnpm dev

# Terminal 2: Test with MCP Inspector
pnpm test:inspector

# Terminal 3: Restart Claude Desktop
./scripts/restart-claude.sh

📦 Available Resources

The MCP server provides access to:

Reference Documents (270+)

• vibekit://reference/AI/claude.md
• vibekit://reference/Framework/nextjs-15.md
• vibekit://reference/Backend/supabase.md
• ...and more

Template Checklists (42)

• Tier 1 (Free): 13 templates - Basic setup, auth, deployment
• Tier 2 (Pro): 16 templates - Payments, notifications, Korean services
• Tier 3 (Max): 15 templates - Enterprise architecture, Kubernetes, observability

Usage in Claude Code

Prompt: "Show me vibekit reference documents"
→ Lists all 270+ reference documents

Prompt: "Load Next.js 15 reference from vibekit"
→ Returns Next.js 15 documentation

Prompt: "Show vibekit template for AI agent planning"
→ Returns tier-1-free AI agent planning checklist

🛠️ Development Scripts

🧪 Testing

# Unit tests
pnpm test

# Security tests only
pnpm test:security

# MCP Inspector
pnpm test:inspector
# Then open http://localhost:6274

📝 Git Submodule Management

Update data submodule

./scripts/update-data.sh

Or manually:

cd data
git pull origin main
cd ..
git add data
git commit -m "chore: update data submodule"

Clone with submodules

git clone --recursive https://github.com/freelife1191/vibe-starter-kit-mcp.git

If you already cloned without --recursive:

git submodule update --init --recursive

🔧 Environment Variables

📚 Documentation

🤝 Contributing

Contributions are welcome! Please read for details.

📄 License

MIT License - see file for details.

🔗 Links

• vibekit Main Repository
• MCP Protocol Documentation
• Issue Tracker

📞 Support

• GitHub Issues: Report a bug or request a feature
• Documentation: Check for detailed guides

Status: 🚧 Under Development (Phase 0)

Last Updated: 2025-10-08