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, Stufenanalysen durchzuführen, Voicings zu generieren und Akkordfolgen zu reharmonisieren, mit Antworten, die berechnet und nicht geraten sind.

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

Nachgeschaltet zu Suno / Udio oder einem anderen Generator? Verpacke die Ausgabe und erhalte eine korrekte Akkordübersicht, der dein Agent vertrauen kann. Und anders als tonal.js oder music21 ist THIRI gehostet und agent-nativ (keine Installation, jede Sprache) – und es reharmonisiert und führt Stimmen, nicht nur Akkorde nachschlagen.

⭐ Wenn das nützlich ist, gib dem Repo einen Stern – es hilft anderen Musikern und Agentenentwicklern, es zu finden.

Musiker: 2-Minuten-Setup (ohne Code)

1. Hol dir einen kostenlosen Schlüssel unter build.thiri.ai/developers
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, reines 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 Vorhaltsnote bleibt erhalten) „Gib mir ein rootloses Cmaj7-Voicing und führe dann die Stimmen nach Dm7.“ → Voicings + eine Stimmführungsbewertung „Reharmonisiere Dm7 G7 Cmaj7 mit Coltrane Changes.“ → Cmaj7 Ab7 Abmaj7 E7

Werkzeuge

Werkzeug	Was es macht
analyze_chord	Akkord → Grundton, Klangqualität, Intervalle, Stufenbezeichnung & harmonische Funktion (Zwischendominanten, Modal-Interchange-Bezeichnungen)
resolve_chord	Akkord → buchstabierte Noten (enharmonisch korrekt), Frequenzen, MIDI, Skalenempfehlungen
generate_voicing	Instrumentengerechte Voicings (rootless/bill_evans, shell, Dreiklang, Pad, Leittöne, Drop-2/3); übergib previousNotes für eine Stimmführungsbewertung; colorPreferences für explizite Spannungsnoten
reharmonize	Akkordfolgen-Reharmonisation – 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 Bandanweisung → Spuren + MIDI (gehostetes MCP v0.3+)

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

Conductor- & Kompositionsbegleiter (nur Desktop)

Für Hör-mich-Agentenschleifen (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	Werkzeuge
thiri-conductor-mcp	conduct_band, render_audio (serverseitiges Csound via POST /v2/render), play_audio, search_csound_corpus
thiri-composition-mcp	Kompositions-IR-Werkzeuge + play_composition (fluidsynth-Vorschau)

Das Rendern läuft ab v0.5.0 serverseitig – keine Csound-Installation erforderlich. Beweis: npm run test:conductor · Live-Dokumentation: build.thiri.ai/lab/conductor-mcp · Agent-Rezepte.

Conductor Agent (Vibe-Komposition)

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

Eintrag	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
Labor-Beweis	build.thiri.ai/lab/conductor-agent

Duale MCP-Konfiguration oben + mapConductResultToStudioModules nach jedem conduct_band. Letztes CLI-Rendering schreibt ~/.thiri/conductor-last.json (nur lokal, nicht committed).

Flagship-Agent-Rezept (analysieren → conduct → rendern → kritisieren)

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

1. Analysieren – „Analysiere Dm7 G7 Cmaj7 in Tonart C mit analyze_chord; fasse Stufen und Spannung zusammen.“
2. Conduct – „conduct_band: warmer Rhodes-Pad, Walking Bass, Besen-Drums, 8 Takte mittlerer Swing in C.“
3. Rendern – „render_audio aus dem Conduct-Ergebnis mit 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-Rendering
mcp.thiri.ai / gehosteter Connector	Nein – nur Theorie + conduct_band-Spuren
Lokal 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/developers und wähle dann 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 Werkzeuge, 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 reines 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_…) – erhalte eines unter build.thiri.ai/developers
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 persönliche, Forschungs- und nichtkommerzielle Nutzung; kommerzielle Nutzung erfordert eine Lizenz (dennison@bluesprincemedia.com). Siehe LICENSE. Versionen, die mit 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 ausgeliefert.