llamabeats-mcp

SamuraiBuddha/llamabeats-mcp

3.2

If you are the rightful owner of llamabeats-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

LlamaBeats MCP is an AI-driven server for controlling WinAmp, offering natural language music playback control and integration with visualization tools.

Tools
3
Resources
0
Prompts
0

LlamaBeats MCP 🦙

An MCP server for WinAmp control - Because it really whips the llama's ass! Control music playback, access visualization data, and manage playlists through AI.

Overview

LlamaBeats MCP brings the legendary WinAmp media player into the age of AI. Control your music with natural language commands like:

  • "Play my 90s throwback playlist"
  • "Skip to the next track"
  • "Boost the bass on this song"
  • "Show me what's playing"

Features (Planned)

Core Functionality

  • ▶️ Playback Control - Play, pause, stop, skip, seek
  • 📋 Playlist Management - Load, create, and modify playlists
  • 🎚️ Volume & EQ - Adjust volume and equalizer settings
  • 📊 Now Playing - Get current track information and position

Advanced Features

  • 🎵 Visualization Data - Access spectrum analyzer and beat detection
  • 🎨 Skin Control - Switch between classic WinAmp skins
  • 🔌 Plugin Integration - Control Milkdrop and other visualizers
  • 🔄 Music Sync - Trigger events based on beat/frequency (for LightFlows integration)

Integration Possibilities

When combined with other MCPs in our ecosystem:

  • LightFlows Integration: Sync RGB lighting to the beat
  • Argos (OBS) Integration: Display now playing info on stream
  • Cyclops Integration: Camera movements synced to music tempo

Installation

# Clone the repository
git clone https://github.com/SamuraiBuddha/llamabeats-mcp.git
cd llamabeats-mcp

# Install dependencies
npm install

# Configure Claude desktop
# Add to claude_desktop_config.json:
{
  "llamabeats": {
    "command": "node",
    "args": ["path/to/llamabeats-mcp/index.js"]
  }
}

Usage Examples

"Play some chill music"
"What song is this?"
"Create a workout playlist"
"Set equalizer for more bass"
"Enable Milkdrop visualizer"

Technical Details

  • Interfaces with WinAmp through its API
  • Provides real-time playback status
  • Exposes visualization data for reactive integrations
  • Supports classic WinAmp file formats (.m3u, .pls)

Requirements

  • WinAmp 5.x or compatible fork
  • Node.js 18+
  • Windows (WinAmp is Windows-only)

Why WinAmp in 2025?

Because sometimes the best tools are the ones that just work. WinAmp's plugin ecosystem, visualization engine, and nostalgic interface make it perfect for creative AI integrations.

Related Projects

License

MIT

"It really whips the llama's ass!" 🦙