THIRI Chord Intelligence

官方

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

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

用音樂理論分析和弦 — 透過 analyze_chord 詢問根音、品質、音程、羅馬數字與和聲功能，包括副屬和弦與調式互換。
解析和弦拼寫 — 使用 resolve_chord 取得同音異名的正確音符、頻率、MIDI 與音階建議，例如「C7sus4 裡有哪些音？」
生成樂器就緒的聲部配置 — 透過 generate_voicing 請求無根音、殼形、三和弦或 drop-2 聲部，並可選擇傳入 previousNotes 以獲得聲部進行評分。
重新和聲進行 — 透過 reharmonize 套用如 tritone_sub、coltrane_changes 或 auto 等技巧，例如「用 Coltrane 變化重新和聲 Dm7 G7 Cmaj7。」
以自然語言指揮樂團 — 使用 conduct_band 將「溫暖的 Rhodes 墊底、行走貝斯、刷鼓」等描述轉換為音軌與 MIDI。

文件

🎷 THIRI Chord Intelligence — MCP 伺服器

為你的 AI 注入真正的音樂理論。 THIRI 是為 AI 開發者打造的確定性音樂理論 MCP 伺服器 + API——它能讓 Claude、Cursor 或任何 MCP 代理分析和弦、執行羅馬數字分析、生成聲部配置（voicings），以及重新和聲（reharmonize）進行，而且答案都是計算出來的，不是猜出來的。

LLM 會幻覺音樂理論：錯誤的音符、虛假的羅馬數字、無法正確聲部連接（voice-lead）的配置。THIRI 是一個確定性引擎（基於 ℤ/12 的音高集合類理論），背後是託管式 API——所以 C7sus4 能保留其掛留音（suspension），Caug 能正確拼寫 C E G#，而「在 Dm7 G7 Cmaj7 上做 Coltrane changes」每次都會回傳 Cmaj7 Ab7 Abmaj7 E7。

在 Suno / Udio 或任何生成器之後使用？ 包裝輸出結果，就能得到你的代理可以信賴的正確和弦圖。而且不像 tonal.js 或 music21，THIRI 是託管式且代理原生（免安裝、支援任何語言）——它還能重新和聲和聲部連接，而不只是查詢和弦。

⭐ 如果這對你有用，請幫 repo 按個星——這能幫助其他音樂人和代理開發者找到它。

👥 加入 AI 音樂建構者社群：想要更高的速率限制、創辦人直接支援，以及即將推出工具的首波使用權？加入我們在 Skool — T.H.I.R.I. Builders 的開發者社群。

音樂人：2 分鐘設定（免寫程式）

在 build.thiri.ai/keys 取得免費金鑰
在 Claude 中：設定 → 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、半減七和弦、借用下屬功能和弦 + 音階選項 「C7sus4 裡面有哪些音？」 → C F G Bb（掛留音會被保留） 「給我一個無根音 Cmaj7 配置，然後聲部連接到 Dm7。」 → 配置 + 聲部連接分數 「用 Coltrane changes 重新和聲 Dm7 G7 Cmaj7。」 → Cmaj7 Ab7 Abmaj7 E7

工具

工具	功能
`analyze_chord`	和弦 → 根音、品質、音程、羅馬數字與和聲功能（含副屬和弦、調式互換標籤）
`resolve_chord`	和弦 → 拼寫音符（含正確的異名同音）、頻率、MIDI、音階建議
`generate_voicing`	樂器可用配置（無根音/bill_evans、shell、三和弦、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 網格引擎——正確的掛留和弦、真實三和弦、異名同音拼寫、所有變化屬和弦——並具備請求逾時、配額回報與結構化錯誤。

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`（伺服器端 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 · 代理食譜。

Conductor Agent（氛圍作曲）

本機氛圍作曲的端到端角色——包含技能、CLI 和 Band 儀表板面板：

入口	指令 / 路徑
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 設定 + 每次 conduct_band 後執行 mapConductResultToStudioModules。最後一次 CLI 渲染會寫入 ~/.thiri/conductor-last.json（僅本機，不會提交）。

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

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

分析 — 「用 analyze_chord 分析 C 調的 Dm7 G7 Cmaj7；總結羅馬數字和張力。」
指揮 — 「conduct_band：溫暖的 Rhodes 墊底、walking bass、刷鼓、C 調中速搖擺 8 小節。」
渲染 — 「以 120 速度從指揮結果 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/keys 取得免費金鑰，然後選擇一種方式：

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 token（`sk_live_…`）——在 build.thiri.ai/keys 取得
`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）；其原始碼不再隨此套件發布。