Butterchurn
FreeNot checkedMilkDrop-style audio-reactive WebGL visualizer via butterchurn — ~2,000 presets, modern GLSL shaders, BPM sync for mixx-dj-mcp. FastMCP 3.4 + zero-install webap
About
MilkDrop-style audio-reactive WebGL visualizer via butterchurn — ~2,000 presets, modern GLSL shaders, BPM sync for mixx-dj-mcp. FastMCP 3.4 + zero-install webapp for Claude Desktop / Cursor.
README
Music visualizer for the fleet: fullscreen animated eye-candy that dances to your music, Winamp-MilkDrop style, with beat sync to the DJ setup (mixx-dj-mcp).
Universal visualizer toolbox — modern WebGL2 GLSL shaders + legacy MilkDrop presets (butterchurn). FastMCP server with BPM sync for mixx-dj-mcp.
Engines
| Engine | What | When to use |
|---|---|---|
| GLSL Shaders | 6 bundled WebGL2 scenes (gyroid, tunnel, plasma, …) | Modern look, no .milk baggage |
| Butterchurn | 500+ community MilkDrop presets | Retro Winamp nostalgia |
Open Toolbox in the webapp to switch engines, preview, and go fullscreen.
The Presets page is a live gallery of every visualizer: each thumbnail renders its own animated preview (up to ~12 WebGL contexts at once, cards activate as you scroll) with search, category/author filters, favorites, a slideshow mode, and a one-click fullscreen view.
Preset library: besides the bundled butterchurn packs (Main/Extra/MD1/Minimal/…),
it ships projectM's MilkDrop presets — the classic "threads of light" particle
and geometric look. ProjectM Original (513) loads eagerly; the large
ProjectM Cream Geo (996) and ProjectM Cream Particles (375) packs lazy-load only
when you browse them.
The Settings page auto-detects local LLM engines (Ollama / LM Studio / vLLM), picks a model resident-first (never evicting a loaded one), and on multi-GPU machines routes local models to the secondary card via a GPU selector.
How it works
The webapp fills the entire browser window with a WebGL canvas running MilkDrop preset visualizations. The built-in beat generator pulses to the current BPM (default 128). Presets cycle through the butterchurn library — click or use arrow keys to switch.
mixx-dj-mcp integration: Send POST /api/bpm { "bpm": 140 } to the backend at 10878 to sync the visualizer's beat to a DJ set.
Quick start
git clone https://github.com/sandraschi/butterchurn-mcp
cd butterchurn-mcp
uv sync
cd webapp; bun install; cd ..
just serve # backend on :10878 + MCP HTTP at /mcp
In another terminal:
just web # Vite dev on :10879
Or use start.ps1 for both at once. It starts the backend (:10878) and the Vite
dev server (:10879) as detached background processes, opens the webapp, and returns
immediately — no hanging terminal. Requires bun on PATH (or auto-detects the default
~\.bun\bin\bun.exe).
API
| Endpoint | Method | Description |
|---|---|---|
/health |
GET | Server status, version, uptime |
/api/bpm |
GET | Current BPM value |
/api/bpm |
POST { "bpm": 140 } |
Set BPM (mixx-dj-mcp sync) |
/api/logs |
GET | Query log entries (limit, level, kind, search, sort, after_id) |
/api/logs/stats |
GET | Ring buffer size / max entries |
/api/logs/export |
GET | Download logs as JSON or CSV |
/api/logs |
DELETE | Clear the log buffer |
/api/llm/gpus |
GET | Enumerate NVIDIA GPUs (index, name, VRAM) for target-GPU placement |
/api/llm/detect |
GET | Local LLM detection: GPU tier + installed/loaded Ollama models |
MCP tools
| Tool | Description |
|---|---|
get_bpm |
Read current BPM |
set_bpm |
Set BPM for visualizer sync |
Ports
| Role | Port |
|---|---|
| Backend (FastAPI + MCP HTTP) | 10878 |
| Frontend (Vite dev) | 10879 |
Documentation
| Doc | Contents |
|---|---|
| Installation | All install methods, prerequisites |
| Product Requirements | Goals, requirements, status |
| Architecture | System architecture, data flow, ports |
| Configuration | Env vars, config options |
| Tool Reference | All available tools |
| Development | Contributing, local setup |
| Troubleshooting | Common issues |
Requirements
- Windows / macOS / Linux
- Python 3.12+ and uv (Option A/C)
- Bun for the webapp dev server (Option A)
- A WebGL2-capable browser (Chrome, Edge, Firefox, Safari)
License
MIT
Installing Butterchurn
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/sandraschi/butterchurn-mcpFAQ
Is Butterchurn MCP free?
Yes, Butterchurn MCP is free — one-click install via Unyly at no cost.
Does Butterchurn need an API key?
No, Butterchurn runs without API keys or environment variables.
Is Butterchurn hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Butterchurn in Claude Desktop, Claude Code or Cursor?
Open Butterchurn on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
ARA
Generate images, video and audio from any AI agent — one connector.
by ARAOmni Video
An MCP server that transforms LLM-enabled IDEs into professional video editors by pre-processing footage into text proxies, generating motion graphics via HTML/
by buildwithtazaYouTube
Transcripts, channel stats, search
by YouTubeEverArt
AI image generation using various models.
by modelcontextprotocolgpu-bridge/mcp-server
GPU inference API for LLMs, image and video generation, TTS, Whisper, embeddings, reranking and OCR, paid per use via x402 or an API key.
by gpu-bridgemerterbak/Grok-MCP
Access xAI's Grok API with agentic tool calling, image generation, vision and file support.
by merterbakSureScaleAI/openai-gpt-image-mcp
Image generation and editing with OpenAI's GPT image models.
by SureScaleAIYangLiangwei/PersonalizationMCP
Aggregate personal data from Steam, YouTube, Bilibili, Spotify, Reddit and other gaming, music, video and social platforms, with OAuth2 and token management.
by YangLiangweiAceDataCloud/MCPFlux
Flux image generation and editing from Black Forest Labs via the Ace Data Cloud API.
by AceDataCloudAceDataCloud/MCPNanoBanana
Nano Banana image generation and editing, including virtual try-on and product placement in realistic scenes.
by AceDataCloudCompare Butterchurn with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All media MCPs
