house-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@house-mcp Analyze ~/Music/reference.mp3 and make a full house arrangement in ~/Music/pack"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
house-mcp
An MCP server that gives an AI assistant two music skills: listen to a reference track and describe it (tempo, key, a chord vamp to match it, where the drops and breakdowns are), and write a complete house arrangement as MIDI, one file per instrument, ready to drop into any DAW.
Ask Claude "make me something like this track" and it can analyze the track, pick the tempo and key, and hand you a 128-bar arrangement with kick, clap, hats, snare build, bass, chord stabs, pad and arpeggio.
Tools
Tool | What it does |
| Reads an |
| Writes a MIDI pack. |
| Lists the |
Bad input (an unknown key, a BPM outside 60 to 200, a missing file) comes back as an
{"error": ...} result the model can read and correct, never a crash.
Related MCP server: Ableton DJ MCP
Quick start
Python 3.10 or newer.
git clone https://github.com/plutothedev/house-mcp
cd house-mcp
pip install -r requirements.txtClaude Code:
claude mcp add house-mcp -- python /absolute/path/to/house-mcp/server.pyClaude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"house-mcp": {
"command": "python",
"args": ["/absolute/path/to/house-mcp/server.py"]
}
}
}Then try: "Analyze ~/Music/reference.mp3, then write a full arrangement in the same key and tempo into ~/Music/house-pack."
How the arrangement is built
The harmony is the two-chord vamp deep and melodic house leans on: the i chord (a minor 7th, or a major 7th in a major key) and a minor 7th a whole step above it, changing every two bars. In G minor that is Gm7 to Am7.
The full arrangement, by bar:
Bars | Section | Playing |
0 to 15 | Intro | Pad, closed hats, a soft kick in bars 12 to 15 |
16 to 31 | Groove | Kick, clap, both hats, bass, chord stabs |
32 to 47 | Breakdown | Pad and bass |
48 to 63 | Build | Bass, busier hats, kick back at bar 56, a snare roll that doubles in speed from bar 56 |
64 to 79 | Drop | Kick, clap, both hats, bass, chord stabs, arpeggio |
80 to 95 | Breakdown | Pad, with the arpeggio in bars 88 to 95 |
96 to 111 | Groove | Kick, clap, both hats, bass, chord stabs |
112 to 127 | Outro | Pad, with kick and closed hats until bar 119 |
Drums use General MIDI notes (kick 36, snare 38, clap 39, closed hat 42, open hat 46). The pitched parts carry notes only: the sound comes from whatever synth or sample you load on each track.
Tempo comes from librosa's beat tracker. Key comes from matching the track's average chroma against the Krumhansl-Kessler key profiles.
What it does not do
It does not control a DAW. FL Studio, for one, has no outside automation API, so the output is MIDI files you import.
It matches notes, not sound. The vibe of a track lives in its patches and samples.
Tempo and key are estimates. Expect the right answer on clear, four-on-the-floor material and check by ear on anything else.
Layout
server.py entry point (python server.py)
house_mcp/
server.py the three MCP tools
arrangement.py builds every part as note events, no I/O
midi.py writes a part to a .mid file
analysis.py tempo, key, vamp and energy map
theory.py note names, MIDI numbers, chord shapes, key profiles
tests/ pytest suiteDevelopment
pip install -r requirements.txt pytest
python -m pytestThe suite covers:
Golden digests: every case's MIDI messages are hashed in
tests/golden.json, so any change to the generated notes fails. For an intended change, runpython -m tests.goldenand review the diff.Musical checks: chord spellings, every note released, notes inside the song, tempo written to every file.
Analysis: tempo, key and energy map checked on synthetic tracks generated inside the tests.
A real MCP round trip: a client starts
server.pyover stdio, lists the tools and calls one.
License
MIT. See LICENSE.
Available Tools
3 toolsanalyze_songA
Analyze a reference audio file (.mp3/.wav). Returns tempo (BPM, house-folded), best key guess + candidates, an approximate 2-chord vamp, and an 8-section energy structure map. Use this first when matching a reference track's vibe.
Inputs: path (required).
generate_arrangementA
Generate a house MIDI pack (separate .mid per instrument) into out_dir.
bpm: tempo, 60 to 200. root: key root note like 'G','A','C#'. mode: 'minor' or 'major' (sets the i-chord quality; the vamp is i7 + ii-m7 a whole step up). arrangement: 'loop' (8-bar groove) or 'full' (128-bar, 8 sections: intro/groove/breakdown/build/drop/breakdown/groove/outro).
Drums use GM notes (kick=36, clap=39, snare=38, closed hat=42, open hat=46). Pitched parts need a synth per channel. Returns the list of written files.
Inputs: out_dir (required), bpm, mode, root, +1 more.
list_packB
List the .mid files in a generated pack folder with sizes.
Inputs: out_dir (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: analyze_song reads audio, generate_arrangement writes MIDI, list_pack inspects output folders. No overlap in resource or action, so misselection is unlikely.
All three tools follow a consistent snake_case verb_noun pattern: analyze_song, generate_arrangement, list_pack. Tense and style are uniform throughout.
Three tools is on the thin side but fits a narrow analyze→generate→inspect workflow without bloat. Each tool earns its place, though one or two more (e.g. regenerate/validate) would round it out.
Core happy path (analyze reference → generate pack → list files) is covered, but the surface has dead ends: no delete/cleanup, no inspecting individual .mid contents, and no way to modify or regenerate a section of an existing arrangement.
Maintenance
Related MCP Connectors
Make full songs with vocals, split stems, transcribe and analyze audio from your AI assistant.
1Make AI Tracks, loops and sound effects, split stems, build drum kits and master songs.
Compose, mix, master and export in Logic Pro, REAPER or Ableton Live by talking to an AI engineer.
AI music production assistant — audio profiling, AI mixing sessions, and service inquiries.
Related MCP Servers
- AlicenseBqualityBmaintenanceIntegrates AI-powered music generation with professional production tools, enabling autonomous music creation workflows from MIDI input to live streaming.225MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI-assisted electronic music production in Ableton Live, with built-in genre theory for indie dance, tech house, melodic techno, and house music.8GPL 3.0
- AlicenseAqualityDmaintenanceEnables AI-driven MIDI composition with chord name support, interactive piano-roll preview, and multiple deployment modes.259MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to listen to MIDI keyboard performances and play notes, chords, loops, and MIDI files into synths, supporting harmonization, replay, and live backing tracks without a DAW.MIT