THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — MCP Sunucusu

Yapay zekânıza gerçek müzik teorisi kazandırın. THIRI, AI geliştiricileri için deterministik 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 üretmesini ve progresyonları reharmonize etmesini sağlar; yanıtlar tahmin değil, hesaplanmış olarak gelir.

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ındaki deterministik bir motordur (ℤ/12 üzerinde pitch-class-set 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 alt katmanında mı çalışıyorsunuz? Çıktıyı sarın ve ajanınızın güvenebileceği doğru bir akor şeması elde edin. Ayrıca tonal.js veya music21'den farklı olarak THIRI barındırılan ve ajan-yerelidir (kurulum gerektirmez, her dilde çalışır) — ve yalnızca akor aramakla kalmaz, reharmonize eder ve ses yönlendirmesi yapar.

⭐ Bu işinize yaradıysa, repoyu yıldızlayın — diğer müzisyenlerin ve ajan geliştiricilerin bunu bulmasına yardımcı olur.

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

1. build.thiri.ai/developers 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ım-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 skoru "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 fonksiyon (sekonder dominantlar, modal-interchange 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); previousNotes ile ses yönlendirme skoru; colorPreferences ile açık gerilimler
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 grup yönlendirmesi → lane'ler + MIDI (barındırılan MCP v0.3+)

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

Conductor ve kompozisyon yardımcıları (yalnızca Desktop)

İşitme ajan döngüleri için (yönlendir → sunucu tarafında render → 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 ile), play_audio, search_csound_corpus
thiri-composition-mcp	Kompozisyon IR araçları + play_composition (fluidsynth önizleme)

Render, 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.

Conductor Ajanı (vibe kompozisyon)

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

Giriş	Komut / yol
Cursor becerisi	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 render'ı ~/.thiri/conductor-last.json yazar (yalnızca yerel, commit edilmez).

Amiral gemisi ajan tarifi (analiz et → yönlendir → render et → eleştir)

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

1. Analiz et — "C anahtarında Dm7 G7 Cmaj7'yi analyze_chord ile analiz et; romen rakamlarını ve gerilimi özetle."
2. Yönlendir — "conduct_band: sıcak Rhodes pad, yürüyen bas, fırça davul, C'de 8 bar orta swing."
3. Render et — "conduct sonucundan 120 tempoda 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 render'ı
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 render edilir (POST /v2/render), yerel olarak çalınır; Csound kurulumu gerekmez

Kurulum

build.thiri.ai/developers 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 adresine bakın.

Ortam değişkenleri

Değişken	Varsayılan	Açıklama
THIRI_API_KEY	(yok)	Bearer token (sk_live_…) — build.thiri.ai/developers 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 adresine bakın. v0.5.0 veya öncesinde yayınlanan sürümler, gönderildikleri MIT/PolyForm çift lisansı altında kalır.

v0.5.0 itibarıyla kompozisyon motoru ve Csound render'ı, barındırılan API'nin arkasında sunucu tarafında çalışır (POST /v2/compose, POST /v2/render); kaynakları artık bu pakette gönderilmez.