THIRI Chord Intelligence MCP Server

chính thức

Công cụ lý thuyết âm nhạc xác định để các tác nhân AI phân tích, giải quyết, tạo giọng và tái hòa âm hợp âm.

Tài liệu

🎷 THIRI Chord Intelligence — Máy chủ MCP

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

Các mô hình ngôn ngữ lớn thường ảo giác về lý thuyết âm nhạc: nốt sai, số La Mã giả, thế bấm không dẫn giọng đúng. THIRI là một công cụ xác định (lý thuyết tập hợp lớp cao độ trên ℤ/12) đằng sau một API được lưu trữ — vì vậy C7sus4 giữ được nốt treo 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úc.

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

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

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

"Phân tích Dm7b5 trong C." → iiø7, bán giảm, mượn át chủ đạo, + các tùy chọn âm giai "Những nốt nào trong C7sus4?" → C F G Bb (nốt treo được giữ nguyên) "Cho tôi một thế bấm Cmaj7 không gốc, sau đó dẫn giọng sang Dm7." → các thế bấ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 → gốc, chất lượng, quãng, số La Mã & chức năng hòa âm (át phụ, nhãn mượn điệu thức)
`resolve_chord`	Hợp âm → các nốt được đánh vần (đúng trùng âm), tần số, MIDI, gợi ý âm giai
`generate_voicing`	Các thế bấm sẵn sàng cho nhạc cụ (không gốc/bill_evans, shell, ba nốt, pad, nốt dẫn, drop-2/3); truyền `previousNotes` để có điểm dẫn giọng; `colorPreferences` cho các căng rõ ràng
`reharmonize`	Tái hòa âm vòng hòa thanh — 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 + MIDI (MCP được lưu trữ v0.3+)

Chạy trên công cụ lưới v2 — đúng các hợp âm sus, bộ ba thực sự, đánh vần trùng âm, tất cả các át biến đổi — với thời gian chờ yêu cầu, báo cáo hạn ngạch và lỗi có cấu trúc.

Csound MCP cục bộ (Chỉ dành cho Desktop)

Đối với các vòng lặp tác nhân nghe-thử (chỉ huy → bản nhạc Csound → WAV), thêm một máy chủ cục bộ thứ hai cùng với 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"]
    }
  }
}

Tệp nhị phân	Công cụ
`thiri-conductor-mcp`	`conduct_band`, `build_csound_score`, `render_csound_wav`, `play_audio`, `search_csound_corpus`, `render_with_tension`
`thiri-composition-mcp`	Công cụ IR soạn nhạc + `play_composition` (xem trước fluidsynth)

Yêu cầu Csound CLI trên PATH để kết xuất WAV. 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 tác nhân.

Tác nhân Chỉ huy (sáng tác vibe)

Tính cách end-to-end cho sáng tác vibe cục bộ — kỹ năng, CLI, và bảng điều khiển Band:

Mục nhập	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 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 kết xuất CLI cuối cùng ghi ~/.thiri/conductor-last.json (chỉ cục bộ, không commit).

Công thức tác nhân hàng đầu (phân tích → chỉ huy → kết xuất → phê bình)

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

Phân tích — "Phân tích Dm7 G7 Cmaj7 trong khóa C với analyze_chord; tóm tắt số La Mã và căng."
Chỉ huy — "conduct_band: pad Rhodes ấm, bass walking, trống chổi, 8 ô nhịp swing vừa trong C."
Kết xuất — "build_csound_score từ các làn, sau đó render_csound_wav ở tempo 120."
Phê bình — "play_audio; phê bình dẫn giọng và cân bằng âm vực; đề xuất một bản sửa đổi."

Toàn bộ lời nhắc: build.thiri.ai/lab/agent-recipes

Ranh giới giữa lưu trữ và cục bộ

Bề mặt	Csound WAV
`mcp.thiri.ai` / trình kết nối được lưu trữ	Không — chỉ lý thuyết + các làn `conduct_band`
`thiri-conductor-mcp` cục bộ	Có — yêu cầu Csound CLI trên máy của bạn

Cài đặt

Nhận khóa miễn phí tại build.thiri.ai/developers, sau đó chọn một cách:

Claude Desktop / web / mobile — được lưu trữ (trình kết nối tùy chỉnh một cú nhấp, không cần cài đặt): Cài đặt → Trình kết nối → Thêm trình kết nối tùy chỉnh → URL https://mcp.thiri.ai/mcp → dán khóa sk_live_ của bạn trên trang đồng ý. Cùng 4 công cụ, cùng khóa, cùng hạn ngạch — không cần tệp 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 thuần? (không cần MCP)

Cùng một công cụ là một API REST thuần túy:

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

Bốn điểm cuối: /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ó)	Token Bearer (`sk_live_…`) — lấy một cái tại build.thiri.ai/developers
`THIRI_API_URL`	`https://chords.thiri.ai`	API base (ghi đè chỉ cho phát triển cục bộ)

Phát triển

npm install && npm run build && npm start