Vibe Coder

Vibe Coder MCP Server empowers your AI assistant to perform development-focused research, planning, and automation. It provides a structured set of tools that you can orchestrate through MCP clients to generate PRDs, user stories, starter kits, code maps, and more, all while keeping outputs organized and secure.

How to use

You connect an MCP client to the Vibe Coder MCP Server and issue natural language requests. The server routes your requests to a suite of tools for research, planning, code analysis, and project generation. You can drive it from a CLI, an interactive REPL, or through an MCP-compatible assistant such as Cursor, Claude Desktop, or Cline AI. Use it to map codebases, generate PRDs, produce user stories, scaffold starter projects, and manage tasks.

How to install

Prerequisites you need before installing include Node.js and a working npm. You will install the MCP server globally for easy access via the vibe command, or you can run it on-demand with npx.

# Prerequisites
node -v
npm -v

# Install globally (recommended for easy CLI access)
npm install -g vibe-coder-mcp@latest

# First-run setup (recommended)
vibe --setup

# Or run instantly with npx (no installation)
npx vibe-coder-mcp@latest --setup

Configuration and quick-start notes

After setup, configure environment variables and MCP client connections to enable full functionality. A key step is providing your OpenRouter API key and designating the project root for Vibe Coder to operate within.

# Example environment setup (via a .env file or your MCP client)
OPENROUTER_API_KEY=your_openrouter_api_key_here
VIBE_PROJECT_ROOT=/path/to/your/project
LOG_LEVEL=info
NODE_ENV=production
VIBE_CODER_OUTPUT_DIR=/path/to/output

Running modes and shutdown

You can run the MCP server in different modes depending on how you want to interact with it. The default stdio transport is suitable for Claude Desktop, Cursor, and similar clients, while SSE/HTTP options provide broader accessibility.

# Production stdio mode (default)
npm start

# Development stdio mode with pretty logs
NODE_ENV=development npm run dev

# SSE/HTTP mode (production)
npm run start:sse

Available tools

research

Performs deep research on technical topics using Perplexity Sonar via OpenRouter and returns summaries with sources.

map-codebase

Analyzes a codebase to produce a detailed map with 35+ language support and Mermaid diagrams or a JSON representation.

curate-context

Curates intelligent context and creates codemaps with caching for AI-driven development.

prd-generator

Generates Product Requirements Documents outlining scope, features, and acceptance criteria.

user-stories-generator

Creates detailed user stories with acceptance criteria for product features.

task-list-generator

Builds structured task lists with dependencies for project delivery.

fullstack-starter-kit-generator

Generates fullstack project starter kits with configurable frontend/backend templates.

rules-generator

Produces project-specific development rules and guidelines.

workflow-runner

Executes predefined tool workflows to automate complex development tasks.

vibe-task-manager

AI-native task management including Recursive Decomposition Design and session persistence.