THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — MCP-Server

Gib deiner KI echte Musiktheorie. THIRI ist der deterministische Musiktheorie-MCP-Server + API für KI-Entwickler – er ermöglicht Claude, Cursor oder jedem MCP-Agenten, Akkorde zu analysieren, römische Ziffern-Analysen durchzuführen, Voicings zu erzeugen und Progressionen zu reharmonisieren – mit Antworten, die berechnet, nicht geraten sind.

LLMs halluzinieren Musiktheorie: falsche Noten, erfundene römische Ziffern, Voicings ohne Stimmführung. THIRI ist eine deterministische Engine (Pitch-Class-Set-Theorie über ℤ/12) hinter einer gehosteten API – so behält C7sus4 seine Suspension, Caug buchstabiert C E G#, und „Coltrane Changes auf Dm7 G7 Cmaj7“ liefert Cmaj7 Ab7 Abmaj7 E7, jedes Mal.

Nutzt du Suno / Udio oder einen anderen Generator? Umschließe die Ausgabe und erhalte ein korrektes Akkorddiagramm, dem dein Agent vertrauen kann. Und anders als tonal.js oder music21 ist THIRI gehostet und agenten-nativ (keine Installation, jede Sprache) – und es reharmonisiert und führt Stimmen, statt nur Akkorde nachzuschlagen.

⭐ Wenn das nützlich ist, star das Repository – es hilft anderen Musikern und Agenten-Entwicklern, es zu finden.

👥 Werde Teil der AI Music Builders: Möchtest du höhere Ratenlimits, direkten Founder-Support und frühen Zugang zu kommenden Tools? Tritt unserer Entwickler-Community auf Skool — T.H.I.R.I. Builders bei.

Musiker: 2-Minuten-Setup (ohne Code)

1. Hol dir einen kostenlosen Schlüssel unter build.thiri.ai/keys
2. In Claude: Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen → URL https://mcp.thiri.ai/mcp → füge deinen sk_live_-Schlüssel ein
3. Frag Claude: „Reharmonisiere Dm7 G7 Cmaj7 mit Coltrane Changes.“

Das war's – keine Installation, keine Konfigurationsdatei. Entwickler: Vollständige Installationsoptionen (Claude Code, Desktop-Konfiguration, rohes HTTP) findest du unten.

Was du fragen kannst

„Analysiere Dm7b5 in C.“ → iiø7, halbvermindert, entlehnte Subdominante, + Skalenoptionen „Welche Noten sind in C7sus4?“ → C F G Bb (die Suspension bleibt erhalten) „Gib mir ein Voicing ohne Grundton für Cmaj7 und führe dann die Stimmen zu Dm7.“ → Voicings + ein Stimmführungs-Score „Reharmonisiere Dm7 G7 Cmaj7 mit Coltrane Changes.“ → Cmaj7 Ab7 Abmaj7 E7

Tools

Tool	Was es tut
analyze_chord	Akkord → Grundton, Qualität, Intervalle, römische Ziffer & harmonische Funktion (Zwischendominanten, Modal-Interchange-Labels)
resolve_chord	Akkord → ausgeschriebene Noten (enharmonisch korrekt), Frequenzen, MIDI, Skalenempfehlungen
generate_voicing	Instrumentenfertige Voicings (ohne Grundton/bill_evans, Shell, Triade, Pad, Guide-Tones, Drop-2/3); übergib previousNotes für einen Stimmführungs-Score; colorPreferences für explizite Spannungen
reharmonize	Progression-Reharmonisierung – 8 Techniken: tritone_sub, ii_v_insertion, modal_interchange, diminished_passing, secondary_dominant, chain_of_dominants, coltrane_changes, backdoor (oder auto)
conduct_band	Natürlichsprachliche Band-Anweisung → Lanes + MIDI (gehosteter MCP v0.3+)

Läuft auf der v2-Grid-Engine – korrekte Sus-Akkorde, echte Dreiklänge, enharmonische Schreibweise, alle alterierten Dominanten – mit Request-Timeouts, Quotenberichterstattung und strukturierten Fehlern.

Conductor- & Kompositions-Begleiter (nur Desktop)

Für Hör-es--Agenten-Schleifen (conduct → serverseitiges Rendern → WAV über deine Lautsprecher) füge einen zweiten lokalen Server neben den gehosteten Theorie-Tools hinzu:

{
  "mcpServers": {
    "thiri": {
      "command": "npx",
      "args": ["-y", "@bluesprincemedia/thiri-mcp"],
      "env": { "THIRI_API_KEY": "sk_live_your_key" }
    },
    "thiri-conductor": {
      "command": "npx",
      "args": ["-y", "@bluesprincemedia/thiri-mcp", "thiri-conductor-mcp"],
      "env": { "THIRI_API_KEY": "sk_live_your_key" }
    },
    "thiri-composition": {
      "command": "npx",
      "args": ["-y", "@bluesprincemedia/thiri-mcp", "thiri-composition-mcp"]
    }
  }
}

Bin	Tools
thiri-conductor-mcp	conduct_band, render_audio (serverseitiges Csound über POST /v2/render), play_audio, search_corpus
thiri-composition-mcp	Kompositions-IR-Tools + play_composition (fluidsynth-Vorschau)

Das Rendern läuft serverseitig seit v0.5.0 – keine Csound-Installation nötig. Beweis: npm run test:conductor · Live-Dokumentation: build.thiri.ai/lab/conductor-mcp · Agenten-Rezepte.

Conductor-Agent (Vibe-Komposition)

End-to-End-Persona für lokale Vibe-Komposition – Skill, CLI und Band-Dashboard-Panel:

Einstieg	Befehl / Pfad
Cursor-Skill	Kopiere THIRI/lab/skills/thiri-conductor-agent/SKILL.md → ~/.cursor/skills/thiri-conductor-agent/SKILL.md
CLI	cd thiri-mcp && npm run conductor:vibe -- "gospel ballad in F minor"
Dashboard	npm run dev:studio → localhost:5173/band → Vibe Conduct-Panel
Lab-Beweis	build.thiri.ai/lab/conductor-agent

Duale MCP-Konfiguration oben + mapConductResultToStudioModules nach jedem conduct_band. Der letzte CLI-Render schreibt ~/.thiri/conductor-last.json (nur lokal, nicht eingecheckt).

Flaggschiff-Agenten-Rezept (analysieren → dirigieren → rendern → kritisieren)

Füge in dieser Reihenfolge nach der dualen MCP-Konfiguration oben ein:

1. Analysieren — „Analysiere Dm7 G7 Cmaj7 in Tonart C mit analyze_chord; fasse römische Ziffern und Spannung zusammen.“
2. Dirigieren — „conduct_band: warmes Rhodes-Pad, Walking Bass, Brush-Drums, 8 Takte mittlerer Swing in C.“
3. Rendern — „render_audio aus dem conduct-Ergebnis bei Tempo 120.“
4. Kritisieren — „play_audio; kritisiere Stimmführung und Registerbalance; schlage eine Überarbeitung vor.“

Vollständige Prompts: build.thiri.ai/lab/agent-recipes

Gehostet vs. lokal – Abgrenzung

Oberfläche	Audio-Render
mcp.thiri.ai / gehosteter Connector	Nein – nur Theorie + conduct_band-Lanes
Lokaler thiri-conductor-mcp	Ja – WAV serverseitig gerendert (POST /v2/render), lokal abgespielt; keine Csound-Installation nötig

Installation

Hol dir einen kostenlosen Schlüssel unter build.thiri.ai/keys, dann wähle einen Weg:

Claude Desktop / Web / Mobil – gehostet (Ein-Klick-Benutzerdefinierter Connector, nichts zu installieren): Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen → URL https://mcp.thiri.ai/mcp → füge deinen sk_live_-Schlüssel auf der Zustimmungsseite ein. Dieselben 5 Tools, derselbe Schlüssel, dasselbe Kontingent – keine Konfigurationsdatei, kein npx.

Claude Code (eine Zeile):

claude mcp add thiri --env THIRI_API_KEY=sk_live_your_key -- npx -y @bluesprincemedia/thiri-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "thiri": {
      "command": "npx",
      "args": ["-y", "@bluesprincemedia/thiri-mcp"],
      "env": { "THIRI_API_KEY": "sk_live_your_key" }
    }
  }
}

Bevorzugst du rohes HTTP? (kein MCP nötig)

Dieselbe Engine ist eine einfache REST-API:

curl -X POST https://chords.thiri.ai/v2/analyze \
  -H "Authorization: Bearer YOUR_KEY" -H "content-type: application/json" \
  -d '{"chord":"Dm7b5","key":"C"}'

Fünf Endpunkte: /v2/analyze, /v2/resolve, /v2/voicing, /v2/reharmonize, /v2/conduct. Siehe openapi.yaml.

Umgebungsvariablen

Variable	Standard	Beschreibung
THIRI_API_KEY	(keine)	Bearer-Token (sk_live_…) – hol dir eines unter build.thiri.ai/keys
THIRI_API_URL	https://chords.thiri.ai	API-Basis (nur für lokale Entwicklung überschreiben)

Entwicklung

npm install && npm run build && npm start

Lizenz

PolyForm Noncommercial 1.0.0 – © 2026 Blues Prince Media. Kostenlos für den privaten, Forschungs- und nichtkommerziellen Gebrauch; kommerzielle Nutzung erfordert eine Lizenz (dennison@bluesprincemedia.com). Siehe LICENSE. Versionen, die bei oder vor v0.5.0 veröffentlicht wurden, bleiben unter der MIT/PolyForm-Doppellizenz, mit der sie ausgeliefert wurden.

Ab v0.5.0 laufen die Kompositions-Engine und der Csound-Renderer serverseitig hinter der gehosteten API (POST /v2/compose, POST /v2/render); ihr Quellcode wird nicht mehr in diesem Paket mitgeliefert.