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 บน Dm7 G7 Cmaj7" คืนค่า Cmaj7 Ab7 Abmaj7 E7 ทุกครั้ง

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

⭐ หากสิ่งนี้มีประโยชน์ ช่วยสตาร์รีโพสิทอรีด้วย — มันช่วยให้นักดนตรีและนักสร้างเอเจนต์คนอื่นๆ เจอสิ่งนี้

👥 เข้าร่วมกลุ่มนักสร้าง AI ดนตรี 55 คนแรก: ต้องการอัตราจำกัดที่สูงขึ้น (300 req/min) การสนับสนุนโดยตรงจากผู้ก่อตั้ง และการเข้าถึงเครื่องมือใหม่ก่อนใคร? เข้าร่วมชุมชนนักพัฒนาของเราบน Skool — Blues People AI

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

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

แค่นั้น — ไม่ต้องติดตั้ง ไม่มีไฟล์คอนฟิก นักพัฒนา: ตัวเลือกการติดตั้งเต็มรูปแบบ (Claude Code, คอนฟิก Desktop, 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)
resolve_chord	คอร์ด → โน้ตที่สะกดแล้ว (ถูกต้องตามเอ็นฮาร์โมนิก), ความถี่, 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 (โฮสต์ MCP v0.3+)

ทำงานบน เอนจินกริด v2 — คอร์ด sus ถูกต้อง, ไทรแอดจริง, การสะกดเอ็นฮาร์โมนิก, โดมิแนนต์ดัดแปลงทั้งหมด — พร้อมเวลาไทม์เอาต์ของคำขอ การรายงานโควตา และข้อผิดพลาดแบบมีโครงสร้าง

คอมปานิออนสำหรับคอนดักเตอร์และการแต่งเพลง (Desktop เท่านั้น)

สำหรับลูปเอเจนต์แบบ ได้ยิน (ควบคุม → เรนเดอร์ฝั่งเซิร์ฟเวอร์ → 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"]
    }
  }
}

ไบนารี	เครื่องมือ
thiri-conductor-mcp	conduct_band, render_audio (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 · สูตรเอเจนต์

คอนดักเตอร์เอเจนต์ (vibe compose)

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

รายการ	คำสั่ง / พาธ
สกิล Cursor	คัดลอก 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"
แดชบอร์ด	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

ขอบเขตระหว่างโฮสต์กับเครื่อง

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

การติดตั้ง

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

Claude Desktop / เว็บ / มือถือ — โฮสต์ (คอนเนกเตอร์กำหนดเองแบบคลิกเดียว ไม่ต้องติดตั้งอะไร): การตั้งค่า → Connectors → Add custom connector → URL https://mcp.thiri.ai/mcp → วางคีย์ sk_live_ ของคุณบนหน้าให้ความยินยอม เครื่องมือ 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" }
    }
  }
}

ชอบ 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 (sk_live_…) — รับได้ที่ build.thiri.ai/developers
THIRI_API_URL	https://chords.thiri.ai	ฐาน API (แทนค่าเฉพาะสำหรับการพัฒนาในเครื่อง)

การพัฒนา

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 ทำงานฝั่งเซิร์ฟเวอร์หลัง API ที่โฮสต์ (POST /v2/compose, POST /v2/render); ซอร์สโค้ดของพวกมันไม่ได้ แจกจ่ายในแพ็กเกจนี้แล้ว