THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — MCP Sunucusu

Yapay zekânıza gerçek müzik teorisi kazandırın. THIRI, yapay zekâ geliştiricileri için deterministik bir müzik teorisi MCP sunucusu + API'sidir — Claude, Cursor veya herhangi bir MCP ajanının akorları analiz etmesini, romen rakamı analizi yapmasını, voicing'ler oluşturmasını ve progresyonları reharmonize etmesini sağlar; yanıtlar tahmin değil, hesaplanmıştır.

LLM'ler müzik teorisinde halüsinasyon görür: yanlış notalar, sahte romen rakamları, ses yönlendirmesi yapmayan voicing'ler. THIRI, barındırılan bir API'nin arkasında deterministik bir motorudur (ℤ/12 üzerinde perde-sınıfı kümesi teorisi) — böylece C7sus4 süspansiyonunu korur, Caug C E G#'u doğru yazar ve "Dm7 G7 Cmaj7 üzerinde Coltrane değişimleri" her seferinde Cmaj7 Ab7 Abmaj7 E7 döndürür.

Suno / Udio veya herhangi bir üretecin akışında mısınız? Çıktıyı sarın ve ajanınızın güvenebileceği doğru bir akor şeması elde edin. tonal.js veya music21'ün aksine, THIRI barındırılan ve ajan-yerelidir (kurulum yok, her dilde) — ve yalnızca akor aramakla kalmaz, reharmonize eder ve ses yönlendirmesi yapar.

⭐ Bu yararlıysa, depoya yıldız verin — müzisyenlerin ve ajan geliştiricilerin bunu bulmasına yardımcı olur.

👥 AI Müzik Yapıcılarına Katılın: Yükseltilmiş hız limitleri, doğrudan kurucu desteği ve yaklaşan araçlara erken erişim ister misiniz? Skool — T.H.I.R.I. Builders topluluğumuza katılın.

Müzisyenler: 2 dakikalık kurulum (kod yok)

1. build.thiri.ai/keys adresinden ücretsiz bir anahtar alın
2. Claude'da: Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle → URL https://mcp.thiri.ai/mcp → sk_live_ anahtarınızı yapıştırın
3. Claude'a sorun: "Dm7 G7 Cmaj7'yi Coltrane değişimleriyle reharmonize et."

Bu kadar — kurulum yok, yapılandırma dosyası yok. Geliştiriciler: tam kurulum seçenekleri (Claude Code, Desktop yapılandırması, ham HTTP) aşağıda.

Neler sorabilirsiniz

"C'de Dm7b5'i analiz et." → iiø7, yarı-eksiltilmiş, ödünç alınmış predominant, + skala seçenekleri "C7sus4'te hangi notalar var?" → C F G Bb (süspansiyon korunur) "Bana köksüz bir Cmaj7 voicing'i ver, sonra Dm7'ye ses yönlendirmesi yap." → voicing'ler + bir ses yönlendirme puanı "Dm7 G7 Cmaj7'yi Coltrane değişimleriyle reharmonize et." → Cmaj7 Ab7 Abmaj7 E7

Araçlar

Araç	Ne yapar
analyze_chord	Akor → kök, kalite, aralıklar, romen rakamı ve harmonik işlev (sekonder dominantlar, modal değişim etiketleri)
resolve_chord	Akor → yazılmış notalar (enharmonik olarak doğru), frekanslar, MIDI, skala önerileri
generate_voicing	Enstrümana hazır voicing'ler (köksüz/bill_evans, shell, triad, pad, guide-tones, drop-2/3); ses yönlendirme puanı için previousNotes geçirin; açık gerilimler için colorPreferences
reharmonize	Progresyon reharmonizasyonu — 8 teknik: tritone_sub, ii_v_insertion, modal_interchange, diminished_passing, secondary_dominant, chain_of_dominants, coltrane_changes, backdoor (veya auto)
conduct_band	Doğal dil bant yönergesi → lane'ler + MIDI (barındırılan MCP v0.3+)

v2 grid motoru üzerinde çalışır — doğru sus akorları, gerçek triadlar, enharmonik yazım, tüm altere dominantlar — istek zaman aşımları, kota raporlaması ve yapılandırılmış hatalarla.

Kondüktör ve kompozisyon yardımcıları (yalnızca Desktop)

İşitme ajan döngüleri için (yönet → sunucu tarafında işle → hoparlörlerinizden WAV), barındırılan teori araçlarının yanına ikinci bir yerel sunucu ekleyin:

{
  "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"]
    }
  }
}

İkili	Araçlar
thiri-conductor-mcp	conduct_band, render_audio (sunucu tarafı Csound, POST /v2/render aracılığıyla), play_audio, search_corpus
thiri-composition-mcp	Kompozisyon IR araçları + play_composition (fluidsynth önizleme)

İşleme, v0.5.0 itibarıyla sunucu tarafında çalışır — Csound kurulumu gerekmez. Kanıt: npm run test:conductor · canlı dokümanlar: build.thiri.ai/lab/conductor-mcp · ajan tarifleri.

Kondüktör Ajanı (vibe kompozisyon)

Yerel vibe kompozisyonu için uçtan uca kişilik — skill, CLI ve Band gösterge paneli:

Giriş	Komut / yol
Cursor skill	THIRI/lab/skills/thiri-conductor-agent/SKILL.md → ~/.cursor/skills/thiri-conductor-agent/SKILL.md kopyalayın
CLI	cd thiri-mcp && npm run conductor:vibe -- "gospel ballad in F minor"
Gösterge paneli	npm run dev:studio → localhost:5173/band → Vibe Conduct paneli
Lab kanıtı	build.thiri.ai/lab/conductor-agent

Yukarıdaki çift MCP yapılandırması + her conduct_band sonrasında mapConductResultToStudioModules. Son CLI işlemesi ~/.thiri/conductor-last.json yazar (yalnızca yerel, taahhüt edilmez).

Amiral gemisi ajan tarifi (analiz → yönet → işle → eleştir)

Yukarıdaki çift MCP yapılandırmasından sonra sırayla yapıştırın:

1. Analiz — "Dm7 G7 Cmaj7'yi C anahtarında analyze_chord ile analiz et; romen rakamlarını ve gerilimi özetle."
2. Yönet — "conduct_band: sıcak Rhodes pad, yürüyen bas, fırça davul, C'de 8 bar orta swing."
3. İşle — "120 tempoda conduct sonucundan render_audio."
4. Eleştir — "play_audio; ses yönlendirmesini ve register dengesini eleştir; bir revizyon öner."

Tam istemler: build.thiri.ai/lab/agent-recipes

Barındırılan vs yerel sınır

Yüzey	Ses işleme
mcp.thiri.ai / barındırılan bağlayıcı	Hayır — yalnızca teori + conduct_band lane'leri
Yerel thiri-conductor-mcp	Evet — WAV sunucu tarafında işlenir (POST /v2/render), yerel olarak çalınır; Csound kurulumu gerekmez

Kurulum

build.thiri.ai/keys adresinden ücretsiz bir anahtar alın, ardından bir yol seçin:

Claude Desktop / web / mobil — barındırılan (tek tıkla özel bağlayıcı, kurulacak bir şey yok): Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle → URL https://mcp.thiri.ai/mcp → onay sayfasında sk_live_ anahtarınızı yapıştırın. Aynı 5 araç, aynı anahtar, aynı kota — yapılandırma dosyası yok, npx yok.

Claude Code (tek satır):

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" }
    }
  }
}

Ham HTTP mi tercih edersiniz? (MCP gerekmez)

Aynı motor, düz bir REST API'dir:

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

Beş uç nokta: /v2/analyze, /v2/resolve, /v2/voicing, /v2/reharmonize, /v2/conduct. openapi.yaml bölümüne bakın.

Ortam değişkenleri

Değişken	Varsayılan	Açıklama
THIRI_API_KEY	(yok)	Bearer token (sk_live_…) — build.thiri.ai/keys adresinden alın
THIRI_API_URL	https://chords.thiri.ai	API tabanı (yalnızca yerel geliştirme için geçersiz kılın)

Geliştirme

npm install && npm run build && npm start

Lisans

PolyForm Noncommercial 1.0.0 — © 2026 Blues Prince Media. Kişisel, araştırma ve ticari olmayan kullanım için ücretsizdir; ticari kullanım lisans gerektirir (dennison@bluesprincemedia.com). LICENSE bölümüne bakın. v0.5.0 veya öncesinde yayınlanan sürümler, birlikte gönderildikleri MIT/PolyForm çift lisansı altında kalır.

v0.5.0 itibarıyla kompozisyon motoru ve Csound işleyici, barındırılan API'nin arkasında sunucu tarafında çalışır (POST /v2/compose, POST /v2/render); kaynak kodları artık bu pakette yer almaz.