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, Stufentheorie-Analysen durchzuführen, Voicings zu erzeugen und Progressionen zu reharmonisieren – mit Antworten, die berechnet, nicht geraten sind.

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

Downstream von Suno / Udio oder einem 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 Repo – das hilft anderen Musikern und Agent-Entwicklern, es zu finden.

👥 Schließe dich den ersten 55 KI-Musik-Buildern an: Möchtest du erhöhte Rate-Limits (300 req/min), direkten Founder-Support und frühen Zugang zu kommenden Tools? Tritt unserer Entwickler-Community auf Skool – Blues People AI bei.

Musiker: 2-Minuten-Setup (ohne Code)

1. Hol dir einen kostenlosen Schlüssel auf build.thiri.ai/developers
2. In Claude: Einstellungen → Connectors → Custom 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 es dann nach 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, Stufe & harmonische Funktion (Zwischendominanten, modal-interchange-Labels)
resolve_chord	Akkord → ausgeschriebene Noten (enharmonisch korrekt), Frequenzen, MIDI, Skalenempfehlungen
generate_voicing	Instrumentenfertige Voicings (rootless/bill_evans, shell, triad, pad, guide-tones, drop-2/3); übergib previousNotes für einen Stimmführungs-Score; colorPreferences für explizite Tensions
reharmonize	Progressions-Reharmonisierung – 8 Techniken: tritone_sub, ii_v_insertion, modal_interchange, diminished_passing, secondary_dominant, chain_of_dominants, coltrane_changes, backdoor (oder auto)
conduct_band	Natural-language-Bandleitung → 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, Quotenmeldung und strukturierten Fehlern.

Conductor- & Kompositions-Begleiter (nur Desktop)

Für **Hör-es-**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	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 Rendering läuft serverseitig ab v0.5.0 – keine Csound-Installation nötig. Beweis: npm run test:conductor · Live-Doku: 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:

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)

Nach der dualen MCP-Konfiguration oben der Reihe nach einfügen:

1. Analysieren – „Analysiere Dm7 G7 Cmaj7 in Tonart C mit analyze_chord; fasse Stufen und Tension zusammen."
2. Dirigieren – „conduct_band: warmes Rhodes-Pad, walking bass, brush drums, 8 Takte Medium 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
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 auf build.thiri.ai/developers und wähle dann einen Weg:

Claude Desktop / Web / Mobile – gehostet (Custom Connector mit einem Klick, nichts zu installieren): Einstellungen → Connectors → Custom 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" }
    }
  }
}

Lieber 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_…) – eines erhalten 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 private, Forschungs- und nichtkommerzielle Zwecke; kommerzielle Nutzung erfordert eine Lizenz (dennison@bluesprincemedia.com). Siehe LICENSE. Versionen, die bei oder vor v0.5.0 veröffentlicht wurden, verbleiben 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 ist nicht mehr in diesem Paket enthalten.