THIRI Chord Intelligence MCP Server

官方

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

文件

🎷 THIRI 和弦智慧 — MCP 伺服器

為你的 AI 賦予真正的樂理能力。 THIRI 是專為 AI 開發者打造的確定性樂理 MCP 伺服器 + API — 它讓 Claude、Cursor 或任何 MCP 代理能夠分析和弦、執行羅馬數字分析、生成聲部配置，並為和弦進行重新配和聲，所有答案都是計算得出，而非猜測。

大型語言模型在樂理上會產生幻覺：錯誤的音符、虛假的羅馬數字、無法正確進行聲部導引的聲部配置。THIRI 是一個託管 API 背後的確定性引擎（基於 ℤ/12 的音級集合論）— 因此 C7sus4 能保留其掛留音，Caug 能正確拼寫 C E G#，而「在 Dm7 G7 Cmaj7 上使用柯川變化」每次都會返回 Cmaj7 Ab7 Abmaj7 E7。

在 Suno / Udio 或任何生成器的下游？ 包裝輸出內容，即可獲得你的代理能夠信任的正確和弦圖表。而且與 tonal.js 或 music21 不同，THIRI 是託管且代理原生的（無需安裝，適用於任何語言）— 並且它能重新配和聲和進行聲部導引，而不僅僅是查詢和弦。

⭐ 如果這對你有用，請為儲存庫加星 — 這能幫助其他音樂家和代理開發者找到它。

你可以詢問的內容

「在 C 調中分析 Dm7b5。」 → iiø7，半減七，借用屬和絃前置，+ 音階選項 「C7sus4 中有哪些音符？」 → C F G Bb（掛留音得以保留） 「給我一個無根音的 Cmaj7 聲部配置，然後聲部導引至 Dm7。」 → 聲部配置 + 聲部導引評分 「用柯川變化為 Dm7 G7 Cmaj7 重新配和聲。」 → Cmaj7 Ab7 Abmaj7 E7

工具

工具	功能描述
`analyze_chord`	和弦 → 根音、性質、音程、羅馬數字與和聲功能（副屬和弦、調式互換標籤）
`resolve_chord`	和弦 → 拼寫音符（等音正確）、頻率、MIDI、音階建議
`generate_voicing`	適用於樂器的聲部配置（無根音/比爾·艾文斯風格、外殼、三和弦、鋪底、導音、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`	自然語言樂隊指揮 → 聲部通道 + MIDI（託管 MCP v0.3+）

運行於 v2 網格引擎 — 正確處理掛留和弦、真實三和弦、等音拼寫、所有變化屬和弦 — 具備請求逾時、配額報告和結構化錯誤。

本地 Csound MCP（僅限桌面版）

對於可聆聽的代理循環（指揮 → Csound 樂譜 → 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`、`build_csound_score`、`render_csound_wav`、`play_audio`、`search_csound_corpus`、`render_with_tension`
`thiri-composition-mcp`	作曲 IR 工具 + `play_composition`（fluidsynth 預覽）

需要 Csound CLI 在 PATH 中以進行 WAV 渲染。證明：npm run test:conductor · 即時文件：build.thiri.ai/lab/conductor-mcp · 代理配方。

指揮代理（氛圍作曲）

用於本地氛圍作曲的端到端角色 — 技能、CLI 和樂隊儀表板面板：

入口	命令 / 路徑
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 → 氛圍指揮面板
實驗室證明	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 鋪底、行走貝斯、刷鼓、C 調 8 小節中等搖擺。」
渲染 — 「從聲部通道 build_csound_score，然後以 120 的速度 render_csound_wav。」
評論 — 「play_audio；評論聲部導引和音域平衡；建議一項修改。」

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

託管與本地的邊界

表面	Csound WAV
`mcp.thiri.ai` / 託管連接器	否 — 僅限樂理 + `conduct_band` 聲部通道
本地 `thiri-conductor-mcp`	是 — 需要在你機器上安裝 Csound CLI

安裝

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

Claude Desktop / 網頁 / 行動版 — 託管（一鍵自訂連接器，無需安裝任何內容）： 設定 → 連接器 → 新增自訂連接器 → URL https://mcp.thiri.ai/mcp → 在同意頁面上貼上你的 sk_live_ 金鑰。相同的 4 個工具、相同的金鑰、相同的配額 — 無需設定檔、無需 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 權杖（`sk_live_…`）— 在 build.thiri.ai/developers 取得
`THIRI_API_URL`	`https://chords.thiri.ai`	API 基礎路徑（僅供本地開發時覆寫）

開發

npm install && npm run build && npm start