Vibe MCp

The ultimate vibe coding tool

An MCP server that generates music based on your coding context. It supports multiple audio generation backends including Stable Audio API and Udio to create short music clips that match what you’re working on, with built-in playback and crossfading between tracks.

Features

• Start a vibe session: Begin generating music based on your current coding context
• Generate more music: Request additional music as the previous chunk is almost finished, with smooth crossfading
• Stop a vibe session: End the music generation session
• Server-side playback: Audio is played directly by the MCP server with automatic crossfading between tracks
• Multiple audio generators: Support for Stable Audio API, Udio, and DiffRhythm
• Instrumental and lyrical modes: Generate either instrumental tracks or music with AI-generated lyrics

Installation

1. Clone this repository

2. Install dependencies:

   npm install
   

3. Install FFmpeg (required for audio playback):

   # macOS
   brew install ffmpeg
   
   # Ubuntu/Debian
   sudo apt-get install ffmpeg
   
   # Windows (using Chocolatey)
   choco install ffmpeg
   

4. Build the project:

   npm run build
   

5. Set up your API keys in the .env file:

   STABLE_AUDIO_KEY=your_stable_audio_key_here
   PIAPI_KEY=your_piapi_key_here
   

   • Get your Stable Audio API key from Stability AI
   • Get your PiAPI key from PiAPI

   Note: You need at least one of these keys to use the MCP server. If you have both, the server will choose the appropriate one based on the generation mode.

Usage

As an MCP Server

To use this as an MCP server with Cline, you need to add it to your MCP settings file:

1. Edit your MCP settings file:

   # For VSCode
   vim ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   # For Cursor
   vim ~/Library/Application\ Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   # For Claude Desktop
   vim ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

2. Add the following configuration:

   {
     "mcpServers": {
       "vibe-mcp": {
         "autoApprove": [
           "start_vibe_session",
           "generate_more_music",
           "stop_vibe_session"
         ],
         "command": "node",
         "args": ["/path/to/vibe-mcp/build/index.js"],
         "env": {
           "STABLE_AUDIO_KEY": "your_stable_audio_key_here",
           "PIAPI_KEY": "your_piapi_key_here"
         }
       }
     }
   }
   

3. Optional command-line arguments:

   • Add lyrical to enable lyrical mode by default: ["/path/to/vibe-mcp/build/index.js", "lyrical"]
   • Add diffrhythm to use the DiffRhythm generator: ["/path/to/vibe-mcp/build/index.js", "lyrical diffrhythm"]