THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — เซิร์ฟเวอร์ MCP

มอบทฤษฎีดนตรีจริงให้ AI ของคุณ THIRI คือ เซิร์ฟเวอร์ MCP ทฤษฎีดนตรี + API แบบดีเทอร์มินิสติกสำหรับนักพัฒนา AI — ช่วยให้ Claude, Cursor หรือเอเจนต์ MCP ใดๆ วิเคราะห์คอร์ด วิเคราะห์เลขโรมัน สร้างเสียงโวอิซซิ่ง และเรียบเรียงคอร์ดใหม่ ด้วยคำตอบที่ คำนวณ ไม่ใช่เดา

LLM มักหลอนทฤษฎีดนตรี: โน้ตผิด เลขโรมันปลอม โวอิซซิ่งที่ไม่นำเสียงถูกต้อง THIRI คือเอนจิน ดีเทอร์มินิสติก (ทฤษฎีเซตพิทช์คลาสบน ℤ/12) ที่อยู่เบื้องหลัง API โฮสต์ — ดังนั้น C7sus4 คงเสียงซัสเพนชันไว้ Caug สะกด C E G# และ "Coltrane changes on Dm7 G7 Cmaj7" คืนค่า Cmaj7 Ab7 Abmaj7 E7 ทุกครั้ง

ใช้งานต่อจาก Suno / Udio หรือเจนเนอเรเตอร์ใดๆ หรือไม่? ห่อผลลัพธ์แล้วได้แผนภูมิคอร์ดที่ถูกต้องซึ่งเอเจนต์ของคุณเชื่อถือได้ และไม่เหมือน tonal.js หรือ music21 THIRI เป็นแบบโฮสต์และเป็นเนทีฟสำหรับเอเจนต์ (ไม่ต้องติดตั้ง ใช้ภาษาใดก็ได้) — และยัง เรียบเรียงใหม่ และ นำเสียง ได้ ไม่ใช่แค่ค้นคอร์ด

⭐ หากมีประโยชน์ กรุณากดดาว repo — ช่วยให้นักดนตรีและนักพัฒนาเอเจนต์คนอื่นพบมัน

👥 เข้าร่วม AI Music Builders: ต้องการอัตราจำกัดที่สูงขึ้น การสนับสนุนจากผู้ก่อตั้งโดยตรง และสิทธิ์เข้าถึงเครื่องมือใหม่ก่อนใคร? เข้าร่วมชุมชนนักพัฒนาของเราบน Skool — T.H.I.R.I. Builders

นักดนตรี: ติดตั้ง 2 นาที (ไม่ต้องเขียนโค้ด)

1. รับคีย์ฟรีที่ build.thiri.ai/keys
2. ใน Claude: Settings → Connectors → Add custom connector → URL https://mcp.thiri.ai/mcp → วางคีย์ sk_live_ ของคุณ
3. ถาม Claude: "Reharmonize Dm7 G7 Cmaj7 with Coltrane changes."

แค่นั้น — ไม่ต้องติดตั้ง ไม่ต้องมีไฟล์คอนฟิก นักพัฒนา: ตัวเลือกการติดตั้งเต็มรูปแบบ (Claude Code, Desktop config, raw HTTP) อยู่ด้านล่าง

สิ่งที่คุณถามได้

"Analyze Dm7b5 in C." → iiø7, ฮาล์ฟ-ดิมินิชด์, borrowed predominant, + ตัวเลือกสเกล "What notes are in C7sus4?" → C F G Bb (เสียงซัสเพนชันยังคงอยู่) "Give me a rootless Cmaj7 voicing, then voice-lead into Dm7." → โวอิซซิ่ง + คะแนนการนำเสียง "Reharmonize Dm7 G7 Cmaj7 with Coltrane changes." → Cmaj7 Ab7 Abmaj7 E7

เครื่องมือ

เครื่องมือ	ฟังก์ชัน
analyze_chord	คอร์ด → ราก คุณภาพ ช่วงเสียง เลขโรมันและฟังก์ชันฮาร์โมนิก (secondary dominants, modal-interchange labels)
resolve_chord	คอร์ด → โน้ตที่สะกดแล้ว (enharmonically correct), ความถี่, MIDI, คำแนะนำสเกล
generate_voicing	โวอิซซิ่งพร้อมใช้สำหรับเครื่องดนตรี (rootless/bill_evans, shell, triad, pad, guide-tones, drop-2/3); ส่ง previousNotes เพื่อรับ คะแนนการนำเสียง; colorPreferences สำหรับเทนชันที่ชัดเจน
reharmonize	การเรียบเรียงคอร์ดใหม่ — 8 เทคนิค: tritone_sub, ii_v_insertion, modal_interchange, diminished_passing, secondary_dominant, chain_of_dominants, coltrane_changes, backdoor (หรือ auto)
conduct_band	การควบคุมวงด้วยภาษาธรรมชาติ → เลน + MIDI (hosted MCP v0.3+)

ทำงานบน v2 grid engine — คอร์ดซัสที่ถูกต้อง ไทรแอดจริง การสะกดเอนฮาร์โมนิก คอร์ดโดมิแนนต์ดัดแปลงทั้งหมด — พร้อม request timeouts, quota reporting และ structured errors

Conductor และคู่หูการแต่งเพลง (Desktop เท่านั้น)

สำหรับลูปเอเจนต์แบบ ฟังได้ (conduct → server-side render → WAV ผ่านลำโพงของคุณ) เพิ่มเซิร์ฟเวอร์ท้องถิ่นตัวที่สองควบคู่กับเครื่องมือทฤษฎีแบบโฮสต์:

{
  "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	เครื่องมือ
thiri-conductor-mcp	conduct_band, render_audio (server-side Csound ผ่าน POST /v2/render), play_audio, search_corpus
thiri-composition-mcp	เครื่องมือ IR การแต่งเพลง + play_composition (พรีวิว fluidsynth)

การเรนเดอร์ทำงาน ฝั่งเซิร์ฟเวอร์ ตั้งแต่ v0.5.0 — ไม่ต้องติดตั้ง Csound หลักฐาน: npm run test:conductor · เอกสารสด: build.thiri.ai/lab/conductor-mcp · สูตรเอเจนต์

Conductor Agent (vibe compose)

บุคลิกแบบครบวงจรสำหรับการแต่งเพลงแบบไวบ์ในเครื่อง — สกิล CLI และแผง Band dashboard:

รายการ	คำสั่ง / พาธ
Cursor skill	คัดลอก 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"
Dashboard	npm run dev:studio → localhost:5173/band → แผง Vibe Conduct
หลักฐานใน Lab	build.thiri.ai/lab/conductor-agent

คอนฟิก MCP คู่ด้านบน + mapConductResultToStudioModules หลังแต่ละ conduct_band การเรนเดอร์ CLI ครั้งสุดท้ายเขียน ~/.thiri/conductor-last.json (เฉพาะเครื่อง ไม่ commit)

สูตรเอเจนต์หลัก (วิเคราะห์ → ควบคุมวง → เรนเดอร์ → วิจารณ์)

วางตามลำดับหลังคอนฟิก MCP คู่ด้านบน:

1. วิเคราะห์ — "Analyze Dm7 G7 Cmaj7 in key C with analyze_chord; summarize roman numerals and tension."
2. ควบคุมวง — "conduct_band: warm Rhodes pad, walking bass, brush drums, 8 bars medium swing in C."
3. เรนเดอร์ — "render_audio from the conduct result at tempo 120."
4. วิจารณ์ — "play_audio; critique voice-leading and register balance; suggest one revision."

พรอมป์เต็ม: build.thiri.ai/lab/agent-recipes

ขอบเขตโฮสต์ vs ท้องถิ่น

พื้นผิว	การเรนเดอร์เสียง
mcp.thiri.ai / hosted connector	ไม่ — ทฤษฎี + เลน conduct_band เท่านั้น
thiri-conductor-mcp ท้องถิ่น	ใช่ — WAV เรนเดอร์ฝั่งเซิร์ฟเวอร์ (POST /v2/render), เล่นในเครื่อง; ไม่ต้องติดตั้ง Csound

การติดตั้ง

รับคีย์ฟรีที่ build.thiri.ai/keys จากนั้นเลือกเส้นทาง:

Claude Desktop / เว็บ / มือถือ — โฮสต์ (คลิกเดียว custom connector ไม่ต้องติดตั้งอะไร): Settings → Connectors → Add custom connector → URL https://mcp.thiri.ai/mcp → วางคีย์ sk_live_ ของคุณบนหน้า consent เครื่องมือ 5 ตัวเดียวกัน คีย์เดียวกัน โควตาเดียวกัน — ไม่มีไฟล์คอนฟิก ไม่มี npx

Claude Code (หนึ่งบรรทัด):

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

ต้องการ raw HTTP หรือไม่? (ไม่ต้องใช้ MCP)

เอนจินเดียวกันนี้เป็น REST API ธรรมดา:

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

ห้าเอนด์พอยต์: /v2/analyze, /v2/resolve, /v2/voicing, /v2/reharmonize, /v2/conduct ดู openapi.yaml

ตัวแปรสภาพแวดล้อม

ตัวแปร	ค่าเริ่มต้น	คำอธิบาย
THIRI_API_KEY	(ไม่มี)	Bearer token (sk_live_…) — รับได้ที่ build.thiri.ai/keys
THIRI_API_URL	https://chords.thiri.ai	API base (แทนที่เฉพาะการพัฒนาท้องถิ่น)

การพัฒนา

npm install && npm run build && npm start

ลิขสิทธิ์

PolyForm Noncommercial 1.0.0 — © 2026 Blues Prince Media. ฟรีสำหรับการใช้ส่วนตัว งานวิจัย และไม่แสวงหาผลกำไร; การใช้เชิงพาณิชย์ต้องมีใบอนุญาต (dennison@bluesprincemedia.com) ดู LICENSE เวอร์ชันที่เผยแพร่ที่หรือ ก่อน v0.5.0 ยังอยู่ภายใต้ลิขสิทธิ์คู่ MIT/PolyForm ที่มาพร้อมกับเวอร์ชันนั้น

ตั้งแต่ v0.5.0 เอนจินการแต่งเพลงและ Csound renderer ทำงานฝั่งเซิร์ฟเวอร์เบื้องหลัง hosted API (POST /v2/compose, POST /v2/render); ซอร์สโค้ดของพวกมันไม่รวมอยู่ใน แพ็กเกจนี้อีกต่อไป