THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — MCP Server

Cung cấp lý thuyết âm nhạc thực sự cho AI của bạn. THIRI là MCP server + API lý thuyết âm nhạc tất định dành cho các nhà xây dựng 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 số La Mã, tạo thế hợp âm, và tái hòa âm các tiến trình với câu trả lời được tính toán, không phải đoán.

Các LLM bịa đặt lý thuyết âm nhạc: nốt sai, số La Mã giả, thế hợp âm không dẫn giọng. THIRI là một engine tất định (lý thuyết tập hợp lớp cao độ trên ℤ/12) đằng sau một API lưu trữ — nên C7sus4 giữ nguyên sự treo (suspension), Caug viết đúng C E G#, và "Coltrane changes trên Dm7 G7 Cmaj7" trả về Cmaj7 Ab7 Abmaj7 E7, mọi lúc.

Đang dùng Suno / Udio hoặc bất kỳ trình tạo nhạc nào? Bọc đầu ra và nhận được biểu đồ hợp âm chính xác mà agent của bạn có thể tin cậy. Và không giống tonal.js hay music21, THIRI được lưu trữ và thân thiện với agent (không cần cài đặt, mọi ngôn ngữ) — và nó tái hòa âm và dẫn 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à xây dựng agent khác tìm thấy nó.

👥 Tham gia 55 Nhà xây dựng Âm nhạc AI Đầu tiên: Muốn giới hạn tốc độ nâng cao (300 req/phút), hỗ trợ trực tiếp từ người sáng lập, và truy cập sớm các công cụ sắp ra mắt? Tham gia cộng đồng nhà phát triển của chúng tôi trên Skool — Blues People AI.

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/developers
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: "Tái hòa âm Dm7 G7 Cmaj7 với Coltrane changes."

Chỉ vậy thôi — 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, bán giảm, âm chủ trước vay mượn, + tùy chọn âm giai "Những nốt nào trong C7sus4?" → C F G Bb (sự treo được giữ nguyên) "Cho tôi một thế hợp âm Cmaj7 không nốt gốc, sau đó dẫn giọng vào Dm7." → các thế hợp âm + điểm dẫn giọng "Tái hòa âm 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, tính chất, quãng, số La Mã & chức năng hòa âm (dominant thứ cấp, nhãn trao đổi điệu thức)
resolve_chord	Hợp âm → các nốt được viết đúng (chính xác về enharmonic), tần số, MIDI, gợi ý âm giai
generate_voicing	Thế hợp â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 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 lane + MIDI (MCP lưu trữ v0.3+)

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

Conductor & các công cụ hỗ trợ sáng tác (chỉ Desktop)

Để có vòng lặp agent nghe được (chỉ huy → render phía server → WAV qua loa của bạn), thêm một server cục bộ thứ hai bên cạnh các công cụ lý thuyết 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"]
    }
  }
}

Nhóm	Công cụ
thiri-conductor-mcp	conduct_band, render_audio (Csound phía server 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 server 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 trọn gói cho sáng tác vibe cục bộ — skill, CLI, và bảng điều khiển Band:

Mục	Lệnh / đường dẫn
Cursor skill	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"
Dashboard	npm run dev:studio → localhost:5173/band → bảng 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 ghi ~/.thiri/conductor-last.json (chỉ cục bộ, không commit).

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 ở giọng C bằng analyze_chord; tóm tắt số La Mã và tension."
2. Chỉ huy — "conduct_band: pad Rhodes ấm, bass walking, trống brush, 8 ô nhịp swing vừa ở C."
3. Render — "render_audio từ kết quả chỉ huy ở tempo 120."
4. Phê bình — "play_audio; phê bình dẫn giọng và cân bằng âm vực; đề xuất một chỉnh sửa."

Prompt đầ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 lưu trữ	Không — chỉ lý thuyết + các lane conduct_band
Cục bộ thiri-conductor-mcp	Có — WAV được render phía server (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/developers, sau đó chọn một cách:

Claude Desktop / web / mobile — lưu trữ (custom connector một cú nhấp, 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/developers
THIRI_API_URL	https://chords.thiri.ai	API base (chỉ ghi đè cho dev 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 cần giấy phép (dennison@bluesprincemedia.com). Xem LICENSE. Các phiên bản phát hành tại hoặc trước v0.5.0 vẫn giữ giấy phép kép MIT/PolyForm mà chúng được phát hành kèm.

Kể từ v0.5.0, engine sáng tác và trình render Csound chạy phía server đằng sau API 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 package này.