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 代理能够分析和弦、执行罗马数字分析、生成声部编配、以及重新和声进行，答案都是计算出来的，而非猜测的。

LLM 会幻觉音乐理论：错误的音符、虚假的罗马数字、无法进行声部引导的编配。THIRI 是一个确定性引擎（基于 ℤ/12 的音级集合理论），运行在托管 API 之后——因此 C7sus4 能保持其挂留音，Caug 能正确拼写 C E G#，而“在 Dm7 G7 Cmaj7 上应用 Coltrane 变化”每次都会返回 Cmaj7 Ab7 Abmaj7 E7。

在 Suno / Udio 或任何生成器之后使用？ 包装输出，即可获得你的代理可以信赖的正确和弦图。与 tonal.js 或 music21 不同，THIRI 是托管且面向代理原生的（无需安装，支持任何语言）——而且它不仅能查和弦，还能重新和声和声部引导。

⭐ 如果这对你有用，请给仓库点个星——这能帮助其他音乐人和代理构建者找到它。

👥 加入 AI 音乐构建者社区：想要更高的速率限制、创始人的直接支持，以及即将推出工具的抢先体验？加入我们在 Skool — T.H.I.R.I. Builders 的开发者社区。

音乐人：2 分钟设置（无需代码）

在 build.thiri.ai/keys 获取免费密钥
在 Claude 中：设置 → 连接器 → 添加自定义连接器 → URL https://mcp.thiri.ai/mcp → 粘贴你的 sk_live_ 密钥
询问 Claude：“用 Coltrane 变化重新和声 Dm7 G7 Cmaj7。”

就这样——无需安装，无需配置文件。构建者：完整的安装选项（Claude Code、桌面配置、原始 HTTP）见下文。

你可以问什么

“分析 C 调中的 Dm7b5。” → iiø7，半减七，借用下属功能，+ 音阶选项 “C7sus4 里有哪些音符？” → C F G Bb（挂留音得以保留） “给我一个无根音 Cmaj7 的声部编配，然后声部引导到 Dm7。” → 编配 + 声部引导评分 “用 Coltrane 变化重新和声 Dm7 G7 Cmaj7。” → Cmaj7 Ab7 Abmaj7 E7

工具

工具	功能
`analyze_chord`	和弦 → 根音、性质、音程、罗马数字与和声功能（副属和弦、调式互换标记）
`resolve_chord`	和弦 → 拼写音符（等音正确）、频率、MIDI、音阶推荐
`generate_voicing`	乐器就绪的声部编配（无根音/bill_evans、壳形、三和弦、铺底、导音、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 网格引擎 上——正确的挂留和弦、真实三和弦、等音拼写、所有变化属和弦——并带有请求超时、配额报告和结构化错误。

指挥与作曲伴侣（仅限桌面端）

用于可听见的代理循环（指挥 → 服务端渲染 → 通过扬声器播放 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 · 代理配方。

指挥代理（氛围作曲）

用于本地氛围作曲的端到端角色——技能、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 → 氛围指挥面板
实验室证明	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 小节。”
渲染 — “以 120 速度从指挥结果 render_audio。”
评论 — “play_audio；评论声部引导和音区平衡；建议一处修改。”

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

托管与本地边界

表面	音频渲染
`mcp.thiri.ai` / 托管连接器	否——仅理论和 `conduct_band` 音轨
本地 `thiri-conductor-mcp`	是——WAV 在服务端渲染（`POST /v2/render`），本地播放；无需安装 Csound

安装

在 build.thiri.ai/keys 获取免费密钥，然后选择一种方式：

Claude Desktop / 网页 / 移动端——托管（一键自定义连接器，无需安装任何东西）： 设置 → 连接器 → 添加自定义连接器 → 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 令牌（`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）；其源代码不再随此包分发。