THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — Server MCP

Beri AI Anda teori musik sungguhan. THIRI adalah server MCP teori musik + API yang deterministik untuk para pembangun AI — ia memungkinkan Claude, Cursor, atau agen MCP mana pun untuk menganalisis akor, menjalankan analisis angka Romawi, menghasilkan voicing, dan mereharmonisasi progresi dengan jawaban yang dihitung, bukan ditebak.

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

Berada di hilir Suno / Udio atau generator lain? Bungkus keluarannya dan dapatkan bagan akor yang benar yang bisa dipercaya agen Anda. Dan tidak seperti tonal.js atau music21, THIRI di-hosting dan bersifat agen-native (tanpa instalasi, bahasa apa pun) — dan ia mereharmonisasi serta menyambungkan suara, bukan sekadar mencari akor.

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

👥 Bergabung dengan 55 Pembangun Musik AI Pertama: Ingin batas rate yang lebih tinggi (300 req/menit), dukungan langsung dari pendiri, dan akses awal ke alat yang akan datang? Bergabunglah dengan komunitas pengembang kami di Skool — Blues People AI.

Musisi: Pengaturan 2 menit (tanpa kode)

1. Dapatkan kunci gratis di build.thiri.ai/developers
2. Di Claude: Settings → Connectors → Add custom connector → URL https://mcp.thiri.ai/mcp → tempel kunci sk_live_ Anda
3. Tanyakan pada Claude: "Reharmonisasi Dm7 G7 Cmaj7 dengan perubahan Coltrane."

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

Apa yang bisa Anda tanyakan

"Analisis Dm7b5 dalam C." → iiø7, half-diminished, predominant pinjaman, + opsi skala "Nada apa saja dalam C7sus4?" → C F G Bb (suspensinya bertahan) "Beri saya voicing Cmaj7 tanpa root, lalu sambungkan suara ke Dm7." → voicing + skor voice-leading "Reharmonisasi Dm7 G7 Cmaj7 dengan perubahan Coltrane." → 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 skala
generate_voicing	Voicing siap-instrumen (rootless/bill_evans, shell, triad, pad, guide-tones, drop-2/3); berikan previousNotes untuk skor voice-leading; 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	Arahan band berbahasa alami → lane + MIDI (MCP v0.3+ yang di-hosting)

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

Pendamping Konduktor & komposisi (khusus Desktop)

Untuk loop agen dengar-ia (conduct → render sisi-server → WAV melalui speaker Anda), tambahkan server lokal kedua di samping alat teori yang di-hosting:

{
  "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 via POST /v2/render), play_audio, search_corpus
thiri-composition-mcp	Alat IR komposisi + play_composition (pratinjau fluidsynth)

Rendering berjalan 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 (lokal saja, tidak di-commit).

Resep agen unggulan (analisis → conduct → 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. Conduct — "conduct_band: pad Rhodes hangat, bass berjalan, drum sikat, 8 birama ayunan sedang dalam C."
3. Render — "render_audio dari hasil conduct pada tempo 120."
4. Kritik — "play_audio; kritik voice-leading dan keseimbangan register; sarankan satu revisi."

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

Batas di-hosting vs lokal

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

Instalasi

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

Claude Desktop / web / seluler — di-hosting (konektor khusus sekali klik, tanpa perlu menginstal apa pun): Settings → Connectors → Add custom connector → 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/developers
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, penelitian, dan nonkomersial; penggunaan komersial memerlukan lisensi (dennison@bluesprincemedia.com). Lihat LICENSE. Versi yang diterbitkan pada atau sebelum v0.5.0 tetap berada di bawah lisensi ganda MIT/PolyForm yang menyertainya.

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