THIRI Chord Intelligence MCP Server

resmi

Yapay zeka ajanlarının akorları analiz etmesi, çözümlemesi, seslendirmesi ve yeniden armonize etmesi için deterministik müzik teorisi motoru.

GitHub

Dokümantasyon

🎷 THIRI Chord Intelligence — MCP Sunucusu

Yapay zekanıza gerçek müzik teorisi verin. THIRI, yapay zeka 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ı, seslendirmeler üretmesini ve ilerleyişleri yeniden armonize etmesini sağlar; yanıtlar tahmin edilmez, hesaplanır.

Büyük dil modelleri müzik teorisinde halüsinasyon görür: yanlış notalar, uydurma romen rakamları, ses yürüyüşü olmayan seslendirmeler. THIRI, barındırılan bir API'nin arkasındaki deterministik bir motordur (ℤ/12 üzerinde perde-sınıfı-küme teorisi) — böylece C7sus4 askı notasını korur, Caug, C E G#'i doğru heceler ve "Dm7 G7 Cmaj7 üzerinde Coltrane değişimleri" her seferinde Cmaj7 Ab7 Abmaj7 E7 döndürür.

Suno / Udio veya herhangi bir üreticinin çıktısını mı işliyorsunuz? Çı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'ün aksine, THIRI barındırılır ve ajana özgüdür (kurulum yok, her dilde) — ve sadece akor aramakla kalmaz, yeniden armonize eder ve ses yürüyüşü yapar.

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

Neler sorabilirsiniz

"Dm7b5'i Do tonunda analiz et." → iiø7, yarı-diminished, ödünç alınmış predominant, + dizi seçenekleri "C7sus4'te hangi notalar var?" → C F G Bb (askı notası korunur) "Bana köksüz bir Cmaj7 seslendirmesi ver, sonra Dm7'ye ses yürüyüşü yap." → seslendirmeler + bir ses yürüyüşü puanı "Dm7 G7 Cmaj7'i Coltrane değişimleriyle yeniden armonize et." → Cmaj7 Ab7 Abmaj7 E7

Araçlar

Araç	Ne yapar
`analyze_chord`	Akor → kök, nitelik, aralıklar, romen rakamı ve armonik işlev (ikincil dominantlar, modal değişim etiketleri)
`resolve_chord`	Akor → hecelenmiş notalar (enarmonik olarak doğru), frekanslar, MIDI, dizi önerileri
`generate_voicing`	Enstrümana hazır seslendirmeler (köksüz/bill_evans, shell, triad, pad, kılavuz-tonlar, drop-2/3); bir ses yürüyüşü puanı için `previousNotes`; açık gerilimler için `colorPreferences` iletin
`reharmonize`	İlerleyiş yeniden armonizasyonu — 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 → kulvarlar + MIDI (barındırılan MCP v0.3+)

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

Yerel Csound MCP (Yalnızca Masaüstü)

Duy-ve-yap ajan döngüleri için (yönet → Csound partisyonu → 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`, `build_csound_score`, `render_csound_wav`, `play_audio`, `search_csound_corpus`, `render_with_tension`
`thiri-composition-mcp`	Kompozisyon IR araçları + `play_composition` (fluidsynth önizleme)

WAV oluşturma için PATH'de Csound CLI gerektirir. Kanıt: npm run test:conductor · canlı dökümanlar: build.thiri.ai/lab/conductor-mcp · ajan tarifleri.

Orkestra Şefi Ajanı (vibe ile beste)

Yerel vibe kompozisyonu için uçtan uca persona — beceri, CLI ve Grup 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
Laboratuvar kanıtı	build.thiri.ai/lab/conductor-agent

Yukarıdaki çift MCP yapılandırması + her conduct_band'den sonra mapConductResultToStudioModules. Son CLI oluşturma ~/.thiri/conductor-last.json yazar (yalnızca yerel, commit edilmez).

Amiral gemisi ajan tarifi (analiz et → yönet → oluştur → eleştir)

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

Analiz Et — "Dm7 G7 Cmaj7'i Do tonunda analyze_chord ile analiz et; romen rakamlarını ve gerilimi özetle."
Yönet — "conduct_band: sıcak Rhodes pad, yürüyen bas, fırça davullar, Do'da 8 ölçü orta swing."
Oluştur — "Kulvarlardan build_csound_score, sonra tempo 120'de render_csound_wav."
Eleştir — "play_audio; ses yürüyüşünü 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	Csound WAV
`mcp.thiri.ai` / barındırılan bağlayıcı	Hayır — yalnızca teori + `conduct_band` kulvarları
Yerel `thiri-conductor-mcp`	Evet — makinenizde Csound CLI gerektirir

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ıklamayla ö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ı 4 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"}'

Dört uç nokta: /v2/analyze, /v2/resolve, /v2/voicing, /v2/reharmonize, /v2/conduct. Bkz. openapi.yaml.

Ortam değişkenleri

Değişken	Varsayılan	Açıklama
`THIRI_API_KEY`	(yok)	Taşıyıcı token (`sk_live_…`) — build.thiri.ai/developers adresinden edinin
`THIRI_API_URL`	`https://chords.thiri.ai`	API temeli (yalnızca yerel geliştirme için geçersiz kılın)

Geliştirme

npm install && npm run build && npm start