THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — Server MCP

Berikan AI Anda teori musik yang nyata. THIRI adalah server MCP teori musik + API yang deterministik untuk para pembangun AI — ini memungkinkan Claude, Cursor, atau agen MCP mana pun untuk menganalisis akor, menjalankan analisis angka romawi, menghasilkan voicing, dan melakukan reharmonisasi progresi dengan jawaban yang dihitung, bukan ditebak.

LLM sering berhalusinasi soal teori musik: nada yang salah, angka romawi palsu, voicing yang tidak memimpin suara dengan benar. THIRI adalah mesin deterministik (teori pitch-class set atas ℤ/12) di balik API yang dihosting — sehingga C7sus4 mempertahankan suspensinya, Caug mengeja C E G#, dan "Coltrane changes pada Dm7 G7 Cmaj7" mengembalikan Cmaj7 Ab7 Abmaj7 E7, setiap saat.

Menggunakan Suno / Udio atau generator lain? Bungkus keluarannya dan dapatkan bagan akor yang benar yang dapat dipercaya oleh agen Anda. Dan tidak seperti tonal.js atau music21, THIRI dihosting dan ramah-agen (tanpa instalasi, bahasa apa pun) — dan ia melakukan reharmonisasi dan memimpin suara, bukan sekadar mencari akor.

⭐ Jika ini bermanfaat, beri bintang pada repositori — ini membantu musisi lain dan pembangun agen menemukannya.

👥 Bergabunglah dengan AI Music Builders: Ingin batas permintaan yang lebih tinggi, dukungan langsung dari pendiri, dan akses awal ke alat yang akan datang? Bergabunglah dengan komunitas pengembang kami di Skool — T.H.I.R.I. Builders.

Musisi: Pengaturan 2 menit (tanpa kode)

1. Dapatkan kunci gratis di build.thiri.ai/keys
2. Di Claude: Pengaturan → Konektor → Tambahkan konektor kustom → URL https://mcp.thiri.ai/mcp → tempel kunci sk_live_ Anda
3. Tanyakan pada Claude: "Reharmonisasi Dm7 G7 Cmaj7 dengan Coltrane changes."

Itu saja — tanpa instalasi, tanpa file konfigurasi. Pembangun: opsi instalasi lengkap (Claude Code, konfigurasi Desktop, HTTP mentah) ada di bawah.

Apa yang bisa Anda tanyakan

"Analisis Dm7b5 dalam C." → iiø7, half-diminished, predominant pinjaman, + opsi tangga nada "Nada apa saja dalam C7sus4?" → C F G Bb (suspensinya tetap bertahan) "Beri saya voicing Cmaj7 tanpa root, lalu pimpin suara ke Dm7." → voicing + skor pemimpin suara "Reharmonisasi Dm7 G7 Cmaj7 dengan Coltrane changes." → Cmaj7 Ab7 Abmaj7 E7

Alat

Alat	Fungsinya
analyze_chord	Akor → root, kualitas, interval, angka romawi & fungsi harmonik (dominant sekunder, label modal-interchange)
resolve_chord	Akor → nada yang dieja (benar secara enharmonik), frekuensi, MIDI, rekomendasi tangga nada
generate_voicing	Voicing siap-instrumen (rootless/bill_evans, shell, triad, pad, guide-tones, drop-2/3); berikan previousNotes untuk skor pemimpin suara; colorPreferences untuk tension eksplisit
reharmonize	Reharmonisasi progresi — 8 teknik: tritone_sub, ii_v_insertion, modal_interchange, diminished_passing, secondary_dominant, chain_of_dominants, coltrane_changes, backdoor (atau auto)
conduct_band	Konduksi band dalam bahasa alami → lane + MIDI (MCP v0.3+ yang dihosting)

Berjalan di mesin grid v2 — akor sus yang benar, triad asli, ejaan enharmonik, semua dominant teralterasi — dengan batas waktu permintaan, pelaporan kuota, dan kesalahan terstruktur.

Pendamping Konduktor & komposisi (Desktop saja)

Untuk loop agen yang bisa mendengar (konduksi → render sisi-server → WAV melalui speaker Anda), tambahkan server lokal kedua di samping alat teori yang dihosting:

{
  "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	Alat
thiri-conductor-mcp	conduct_band, render_audio (Csound sisi-server melalui POST /v2/render), play_audio, search_corpus
thiri-composition-mcp	Alat IR komposisi + play_composition (pratinjau fluidsynth)

Rendering berjalan di sisi-server sejak v0.5.0 — tanpa perlu instalasi Csound. Bukti: npm run test:conductor · dokumen langsung: build.thiri.ai/lab/conductor-mcp · resep agen.

Agen Konduktor (komposisi vibe)

Persona ujung-ke-ujung untuk komposisi vibe lokal — skill, CLI, dan panel dasbor Band:

Entri	Perintah / jalur
Skill Cursor	Salin 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"
Dasbor	npm run dev:studio → localhost:5173/band → panel Vibe Conduct
Bukti lab	build.thiri.ai/lab/conductor-agent

Konfigurasi MCP ganda di atas + mapConductResultToStudioModules setelah setiap conduct_band. Render CLI terakhir menulis ~/.thiri/conductor-last.json (hanya lokal, tidak dikomit).

Resep agen unggulan (analisis → konduksi → render → kritik)

Tempel secara berurutan setelah konfigurasi MCP ganda di atas:

1. Analisis — "Analisis Dm7 G7 Cmaj7 dalam kunci C dengan analyze_chord; rangkum angka romawi dan tension."
2. Konduksi — "conduct_band: pad Rhodes hangat, walking bass, drum brush, 8 bar medium swing dalam C."
3. Render — "render_audio dari hasil konduksi pada tempo 120."
4. Kritik — "play_audio; kritik pemimpin suara dan keseimbangan register; sarankan satu revisi."

Prompt lengkap: build.thiri.ai/lab/agent-recipes

Batas hosted vs lokal

Permukaan	Render audio
mcp.thiri.ai / konektor hosted	Tidak — hanya teori + lane conduct_band
thiri-conductor-mcp lokal	Ya — WAV dirender di sisi-server (POST /v2/render), diputar secara lokal; tanpa instalasi Csound

Instalasi

Dapatkan kunci gratis di build.thiri.ai/keys, lalu pilih jalur:

Claude Desktop / web / seluler — hosted (konektor kustom satu-klik, tanpa instalasi): Pengaturan → Konektor → Tambahkan konektor kustom → URL https://mcp.thiri.ai/mcp → tempel kunci sk_live_ Anda di halaman persetujuan. 5 alat yang sama, kunci yang sama, kuota yang sama — tanpa file konfigurasi, tanpa npx.

Claude Code (satu baris):

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

Lebih suka HTTP mentah? (tanpa MCP)

Mesin yang sama adalah API REST biasa:

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

Lima endpoint: /v2/analyze, /v2/resolve, /v2/voicing, /v2/reharmonize, /v2/conduct. Lihat openapi.yaml.

Variabel lingkungan

Variabel	Default	Deskripsi
THIRI_API_KEY	(tidak ada)	Token Bearer (sk_live_…) — dapatkan di build.thiri.ai/keys
THIRI_API_URL	https://chords.thiri.ai	Basis API (timpa hanya untuk pengembangan lokal)

Pengembangan

npm install && npm run build && npm start

Lisensi

PolyForm Noncommercial 1.0.0 — © 2026 Blues Prince Media. Gratis untuk penggunaan pribadi, riset, dan nonkomersial; penggunaan komersial memerlukan lisensi (dennison@bluesprincemedia.com). Lihat LICENSE. Versi yang diterbitkan pada atau sebelum v0.5.0 tetap di bawah lisensi ganda MIT/PolyForm yang mereka bawa saat dirilis.

Sejak v0.5.0, mesin komposisi dan renderer Csound berjalan di sisi-server di belakang API yang dihosting (POST /v2/compose, POST /v2/render); sumbernya tidak lagi disertakan dalam paket ini.