THIRI Chord Intelligence

官方

為AI代理提供確定性音樂理論引擎，用於分析和弦、解決和弦、配置聲部及重新編配和聲。

你可以用 THIRI Chord Intelligence MCP 做什麼？

分析和弦結構 — 呼叫 analyze_chord 以取得任何調性中和弦的根音、品質、音程、羅馬數字與和聲功能。
解析和弦音符 — 使用 resolve_chord 取得異音同名的正確拼寫、頻率、MIDI 數值與音階建議。
生成樂器聲部配置 — 請求 generate_voicing，可指定如 rootless、shell 或 drop-2 等風格，並傳入 previousNotes 以進行聲部連接評分。
重新和聲進行 — 套用 reharmonize，搭配如 tritone_sub、coltrane_changes 或 auto 等技巧，轉換和弦進行。
指揮樂團 — 使用 conduct_band 將自然語言指令轉換為樂器音軌與 MIDI 輸出。

文件

🎷 THIRI Chord Intelligence — MCP 伺服器

為你的 AI 注入真正的樂理。 THIRI 是為 AI 開發者打造的決定性（deterministic）樂理 MCP 伺服器 + API——讓 Claude、Cursor 或任何 MCP 代理程式分析和弦、執行羅馬數字分析、生成聲部編排（voicings）並重新和聲（reharmonize）和弦進行，所有答案都是經由計算得出，而非猜測。

LLM 經常在樂理上產生幻覺：錯誤的音符、虛假的羅馬數字、聲部連接不當的 voicings。THIRI 是位於代管 API 後方的決定性引擎（基於 ℤ/12 的音級集合論）——因此 C7sus4 能保留其掛留音，Caug 能正確拼寫 C E G#，而「Dm7 G7 Cmaj7 上的 Coltrane changes」每次都會回傳 Cmaj7 Ab7 Abmaj7 E7。

位於 Suno / Udio 或其他生成器下游？ 包裝輸出即可獲得你的代理程式可以信賴的正確和弦圖。而且不同於 tonal.js 或 music21，THIRI 是代管且原生支援代理程式（無需安裝、任何語言皆可）——它還能執行重新和聲與聲部連接，而不只是查詢和弦。

⭐ 如果這個專案對你有用，請幫我們 star 這個 repo——這能幫助其他音樂人與 AI 開發者找到它。

👥 加入首批 55 位 AI 音樂開發者：想要更高的速率限制（300 req/min）、創辦人直通支援，以及即將推出工具的首波使用權？歡迎加入我們的開發者社群 Skool — Blues People AI。

音樂人：2 分鐘設定（無需程式碼）

在 build.thiri.ai/developers 免費取得金鑰
在 Claude 中：Settings → Connectors → Add custom connector → URL https://mcp.thiri.ai/mcp → 貼上你的 sk_live_ 金鑰
詢問 Claude：「用 Coltrane changes 重新和聲 Dm7 G7 Cmaj7。」

就是這麼簡單——無需安裝、無需設定檔。開發者：完整的安裝選項（Claude Code、Desktop 設定檔、純 HTTP）請見下方。

你可以詢問什麼

「分析 C 調中的 Dm7b5。」 → iiø7、半減七、借用下屬和弦（borrowed predominant）、音階選項 「C7sus4 包含哪些音符？」 → C F G Bb（掛留音會被保留） 「給我一個無根音 Cmaj7 voicing，然後聲部連接到 Dm7。」 → voicings + 聲部連接評分 「用 Coltrane changes 重新和聲 Dm7 G7 Cmaj7。」 → Cmaj7 Ab7 Abmaj7 E7

工具

工具	功能
`analyze_chord`	和弦 → 根音、品質、音程、羅馬數字與和聲功能（次屬和弦、調式互換標籤）
`resolve_chord`	和弦 → 正確拼寫的音符（等音正確）、頻率、MIDI、音階建議
`generate_voicing`	可直接演奏的 voicings（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`	自然語言樂團指揮 → 聲部（lanes）+ MIDI（代管 MCP v0.3+）

運行於 v2 grid engine 之上——正確的掛留和弦、真實三和弦、等音拼寫、所有變化屬和弦——並具備請求逾時、配額回報與結構化錯誤。

Conductor 與作曲伴侶工具（僅限 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`（透過 `POST /v2/render` 進行伺服器端 Csound 渲染）、`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（氛圍作曲）

用於本機氛圍作曲的端對端人設——包含 skill、CLI 與 Band 儀表板面板：

入口	指令 / 路徑
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"`
儀表板	`npm run dev:studio` → localhost:5173/band → Vibe Conduct 面板
Lab 實證	build.thiri.ai/lab/conductor-agent

上述雙重 MCP 設定 + 每次 conduct_band 後執行 mapConductResultToStudioModules。最後一次 CLI 渲染會寫入 ~/.thiri/conductor-last.json（僅限本機，不會提交）。

旗艦代理程式食譜（分析 → 指揮 → 渲染 → 評論）

在上述雙重 MCP 設定之後依序貼上：

分析 — 「使用 analyze_chord 分析 C 調中的 Dm7 G7 Cmaj7；總結羅馬數字與張力。」
指揮 — 「conduct_band：溫暖的 Rhodes pad、walking bass、刷鼓、C 調 8 小節中速搖擺。」
渲染 — 「以 120 速度從 conduct 結果 render_audio。」
評論 — 「play_audio；評論聲部連接與音域平衡；建議一項修改。」

完整提示詞：build.thiri.ai/lab/agent-recipes

代管 vs 本機的界線

介面	音訊渲染
`mcp.thiri.ai` / 代管連接器	否——僅樂理 + `conduct_band` 聲部
本機 `thiri-conductor-mcp`	是——WAV 在伺服器端渲染（`POST /v2/render`），在本機播放；無需安裝 Csound

安裝

在 build.thiri.ai/developers 免費取得金鑰，然後選擇一種方式：

Claude Desktop / 網頁 / 行動版——代管（一鍵自訂連接器，無需安裝任何東西）： Settings → 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 token（`sk_live_…`）——請至 build.thiri.ai/developers 取得
`THIRI_API_URL`	`https://chords.thiri.ai`	API 基礎網址（僅本機開發時覆寫）

開發

npm install && npm run build && npm start

授權

自 v0.5.0 起，作曲引擎與 Csound 渲染器在代管 API 後方以伺服器端執行（POST /v2/compose、POST /v2/render）；其原始碼不再隨本套件發布。