THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — MCP Server

Cung cấp cho AI của bạn lý thuyết âm nhạc thực sự. THIRI là MCP server lý thuyết âm nhạc + API mang tính xác định dành cho các nhà phát triển AI — nó cho phép Claude, Cursor, hoặc bất kỳ agent MCP nào phân tích hợp âm, chạy phân tích chữ số La Mã, tạo cách bấm hợp âm (voicings), và tái hòa âm (reharmonize) các tiến trình với câu trả lời được tính toán, không phải đoán mò.

Các LLM thường bịa ra lý thuyết âm nhạc: nốt sai, chữ số La Mã giả, cách bấm hợp âm không dẫn dắt giọng (voice-lead). THIRI là một engine xác định (lý thuyết pitch-class-set trên ℤ/12) đằng sau một API được lưu trữ — vì vậy C7sus4 giữ nguyên độ trễ (suspension) của nó, Caug đánh vần C E G#, và "Coltrane changes trên Dm7 G7 Cmaj7" trả về Cmaj7 Ab7 Abmaj7 E7, mỗi lần.

Hoạt động sau Suno / Udio hoặc bất kỳ trình tạo nào? Bọc đầu ra và nhận được một bảng hợp âm chính xác mà agent của bạn có thể tin tưởng. Và không giống như tonal.js hoặc music21, THIRI được lưu trữ và thân thiện với agent (không cần cài đặt, bất kỳ ngôn ngữ nào) — và nó tái hòa âm và dẫn dắt giọng, không chỉ tra cứu hợp âm.

⭐ Nếu hữu ích, hãy star repo — điều đó giúp các nhạc sĩ và nhà phát triển agent khác tìm thấy nó.

👥 Tham gia AI Music Builders: Bạn muốn giới hạn tốc độ cao hơn, hỗ trợ trực tiếp từ nhà sáng lập, và truy cập sớm vào các công cụ sắp tới? Tham gia cộng đồng nhà phát triển của chúng tôi trên Skool — T.H.I.R.I. Builders.

Nhạc sĩ: Thiết lập trong 2 phút (không cần code)

1. Lấy key miễn phí tại build.thiri.ai/keys
2. Trong Claude: Settings → Connectors → Add custom connector → URL https://mcp.thiri.ai/mcp → dán key sk_live_ của bạn
3. Hỏi Claude: "Reharmonize Dm7 G7 Cmaj7 với Coltrane changes."

Vậy là xong — không cần cài đặt, không cần file cấu hình. Nhà phát triển: các tùy chọn cài đặt đầy đủ (Claude Code, cấu hình Desktop, HTTP thô) ở bên dưới.

Những gì bạn có thể hỏi

"Phân tích Dm7b5 trong C." → iiø7, half-diminished, âm mượn (borrowed predominant), + các tùy chọn âm giai "Các nốt trong C7sus4 là gì?" → C F G Bb (độ trễ được giữ nguyên) "Cho tôi một cách bấm Cmaj7 không có nốt gốc (rootless), sau đó dẫn dắt giọng vào Dm7." → các cách bấm + điểm dẫn dắt giọng "Reharmonize Dm7 G7 Cmaj7 với Coltrane changes." → Cmaj7 Ab7 Abmaj7 E7

Công cụ

Công cụ	Chức năng
analyze_chord	Hợp âm → nốt gốc, chất lượng, quãng, chữ số La Mã & chức năng hòa âm (dominant thứ cấp, nhãn trao đổi modal)
resolve_chord	Hợp âm → các nốt được đánh vần (đúng về mặt enharmonic), tần số, MIDI, gợi ý âm giai
generate_voicing	Các cách bấm sẵn sàng cho nhạc cụ (rootless/bill_evans, shell, triad, pad, guide-tones, drop-2/3); truyền previousNotes để có điểm dẫn dắt giọng; colorPreferences cho các tension tường minh
reharmonize	Tái hòa âm tiến trình — 8 kỹ thuật: tritone_sub, ii_v_insertion, modal_interchange, diminished_passing, secondary_dominant, chain_of_dominants, coltrane_changes, backdoor (hoặc auto)
conduct_band	Chỉ huy ban nhạc bằng ngôn ngữ tự nhiên → các làn (lanes) + MIDI (MCP v0.3+ được lưu trữ)

Chạy trên v2 grid engine — hợp âm sus chính xác, hợp âm ba thực sự, đánh vần enharmonic, tất cả các dominant biến đổi — với thời gian chờ yêu cầu, báo cáo hạn mức, và lỗi có cấu trúc.

Bạn đồng hành Conductor & composition (chỉ Desktop)

Cho các vòng lặp agent nghe được (chỉ huy → render phía máy chủ → WAV qua loa của bạn), thêm một máy chủ cục bộ thứ hai bên cạnh các công cụ lý thuyết được lưu trữ:

{
  "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	Công cụ
thiri-conductor-mcp	conduct_band, render_audio (Csound phía máy chủ qua POST /v2/render), play_audio, search_corpus
thiri-composition-mcp	Công cụ IR sáng tác + play_composition (xem trước fluidsynth)

Việc render chạy phía máy chủ kể từ v0.5.0 — không cần cài đặt Csound. Bằng chứng: npm run test:conductor · tài liệu trực tiếp: build.thiri.ai/lab/conductor-mcp · công thức agent.

Conductor Agent (sáng tác theo vibe)

Persona đầu cuối cho sáng tác vibe cục bộ — kỹ năng, CLI, và bảng điều khiển Band:

Mục	Lệnh / đường dẫn
Kỹ năng Cursor	Sao chép 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"
Bảng điều khiển	npm run dev:studio → localhost:5173/band → bảng điều khiển Vibe Conduct
Bằng chứng Lab	build.thiri.ai/lab/conductor-agent

Cấu hình MCP kép ở trên + mapConductResultToStudioModules sau mỗi conduct_band. Lần render CLI cuối cùng ghi ~/.thiri/conductor-last.json (chỉ cục bộ, không cam kết).

Công thức agent chủ lực (phân tích → chỉ huy → render → phê bình)

Dán theo thứ tự sau cấu hình MCP kép ở trên:

1. Phân tích — "Phân tích Dm7 G7 Cmaj7 trong key C với analyze_chord; tóm tắt chữ số La Mã và tension."
2. Chỉ huy — "conduct_band: đệm Rhodes ấm, bass đi bộ, trống chải, 8 ô nhịp swing vừa phải trong C."
3. Render — "render_audio từ kết quả conduct ở tempo 120."
4. Phê bình — "play_audio; phê bình dẫn dắt giọng và cân bằng âm vực; đề xuất một sửa đổi."

Lời nhắc đầy đủ: build.thiri.ai/lab/agent-recipes

Ranh giới lưu trữ vs cục bộ

Bề mặt	Render âm thanh
mcp.thiri.ai / connector được lưu trữ	Không — chỉ lý thuyết + các làn conduct_band
thiri-conductor-mcp cục bộ	Có — WAV được render phía máy chủ (POST /v2/render), phát cục bộ; không cần cài đặt Csound

Cài đặt

Lấy key miễn phí tại build.thiri.ai/keys, sau đó chọn một đường dẫn:

Claude Desktop / web / mobile — được lưu trữ (connector tùy chỉnh một cú nhấp chuột, không cần cài đặt gì): Settings → Connectors → Add custom connector → URL https://mcp.thiri.ai/mcp → dán key sk_live_ của bạn trên trang đồng ý. Cùng 5 công cụ, cùng key, cùng hạn mức — không cần file cấu hình, không cần npx.

Claude Code (một dòng):

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

Thích HTTP thô? (không cần MCP)

Cùng engine đó là một REST API đơn giản:

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

Năm endpoint: /v2/analyze, /v2/resolve, /v2/voicing, /v2/reharmonize, /v2/conduct. Xem openapi.yaml.

Biến môi trường

Biến	Mặc định	Mô tả
THIRI_API_KEY	(không có)	Bearer token (sk_live_…) — lấy tại build.thiri.ai/keys
THIRI_API_URL	https://chords.thiri.ai	API base (chỉ ghi đè cho phát triển cục bộ)

Phát triển

npm install && npm run build && npm start

Giấy phép

PolyForm Noncommercial 1.0.0 — © 2026 Blues Prince Media. Miễn phí cho mục đích cá nhân, nghiên cứu, và phi thương mại; sử dụng thương mại yêu cầu giấy phép (dennison@bluesprincemedia.com). Xem LICENSE. Các phiên bản được phát hành tại hoặc trước v0.5.0 vẫn thuộc giấy phép kép MIT/PolyForm mà chúng được phát hành.

Kể từ v0.5.0, engine sáng tác và trình render Csound chạy phía máy chủ đằng sau API được lưu trữ (POST /v2/compose, POST /v2/render); mã nguồn của chúng không còn được đóng gói trong gói này.