THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — MCP Sunucusu

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

LLM'ler müzik teorisinde halüsinasyon görür: yanlış notalar, sahte roman rakamları, voice-leading yapmayan voicing'ler. THIRI, barındırılan bir API'nin arkasındaki deterministik bir motorudur (ℤ/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 downstream'inde misiniz? Çıktıyı sarın ve ajanınızın güvenebileceği doğru bir akor şeması elde edin. Ve tonal.js veya music21'ün aksine, THIRI barındırılan ve ajan-yerel (kurulum gerektirmez, her dilde çalışır) bir çözümdür — ayrıca sadece akor aramakla kalmaz, reharmonize eder ve voice-leading yapar.

⭐ Bu işinize yaradıysa, repoya yıldız verin — diğer müzisyenlerin ve ajan geliştiricilerinin bunu bulmasına yardımcı olur.

👥 İlk 55 Yapay Zekâ Müzik Geliştiricisine Katılın: Yükseltilmiş hız limitleri (300 istek/dk), doğrudan kurucu desteği ve yaklaşan araçlara erken erişim ister misiniz? Skool — Blues People AI topluluğumuza katılın.

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 voice-leading yap." → voicing'ler + bir voice-leading 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, roman 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); bir voice-leading skoru için previousNotes geçirin; açık tension'lar 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 grup yönetimi → 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 birlikte.

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

İşitme ajan döngüleri için (conduct → sunucu tarafı 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"]
    }
  }
}

Paket	Araçlar
thiri-conductor-mcp	conduct_band, render_audio (POST /v2/render üzerinden sunucu tarafı Csound), play_audio, search_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 compose)

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 render'ı ~/.thiri/conductor-last.json dosyasını yazar (yalnızca yerel, commit edilmez).

Amiral gemisi ajan tarifi (analiz → conduct → render → eleştiri)

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

1. Analiz — "Dm7 G7 Cmaj7'yi C tonunda analyze_chord ile analiz et; roman rakamlarını ve tension'ı özetle."
2. Conduct — "conduct_band: sıcak Rhodes pad, walking bas, fırça davul, C'de 8 bar orta swing."
3. Render — "conduct sonucundan 120 tempoda render_audio."
4. Eleştiri — "play_audio; voice-leading ve register dengesini eleştir; bir revizyon öner."

Tam prompt'lar: 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'sidir:

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/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 bir lisans gerektirir (dennison@bluesprincemedia.com). LICENSE bölümüne bakın. v0.5.0 veya öncesinde yayınlanan sürümler, birlikte yayınlandıkları MIT/PolyForm çift lisansı kapsamında kalır.

v0.5.0 itibarıyla kompozisyon motoru ve Csound renderleyici, 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.