THIRI Chord Intelligence

官方

为AI智能体提供确定性乐理引擎，用于分析和弦、解决和弦、声部配置及和弦再编配。

GitHub

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

分析和弦功能 — 调用 analyze_chord 返回任意调内和弦的根音、性质、音程、罗马数字和声功能。
解析和弦音符 — 使用 resolve_chord 获取等音正确的拼写音符、MIDI 值、频率和音阶推荐。
生成乐器声部 — 请求 generate_voicing，支持无根音、壳式或 drop-2 等风格，并在传入前序音符时提供声部进行评分。
重新和声进行 — 对任意和弦序列应用 reharmonize 技巧，如三全音替代、Coltrane 变化或副属和弦。
指挥乐队 — 使用 conduct_band 将自然语言指令转换为乐器音轨和 MIDI 数据。

文档

🎷 THIRI 和弦智能 — MCP 服务器

为你的 AI 赋予真正的音乐理论。 THIRI 是为 AI 构建者打造的确定性音乐理论 MCP 服务器 + API — 它能让 Claude、Cursor 或任何 MCP 智能体分析和弦、进行罗马数字分析、生成声部排列以及为和弦进行重新配和声，给出的答案是计算得出的，而非猜测的。

大语言模型会在音乐理论上产生幻觉：错误的音符、虚假的罗马数字、没有声部引导的声部排列。THIRI 是一个托管 API 背后的确定性引擎（基于 ℤ/12 的音级集合理论）— 因此 C7sus4 会保留其挂留音，Caug 会拼写 C E G#，而“在 Dm7 G7 Cmaj7 上的 Coltrane 变化”每次都会返回 Cmaj7 Ab7 Abmaj7 E7。

在 Suno / Udio 或任何生成器的下游？ 封装输出，即可获得你的智能体可以信赖的正确和弦谱。而且与 tonal.js 或 music21 不同，THIRI 是托管且智能体原生的（无需安装，任何语言）— 并且它能重新配和声和进行声部引导，而不仅仅是查找和弦。

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

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

在 build.thiri.ai/developers 获取免费密钥
在 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`	适合乐器的声部排列（无根音/比尔·埃文斯、壳状、三和弦、铺垫、导音、降二/降三）；传递 `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_csound_corpus`
`thiri-composition-mcp`	作曲 IR 工具 + `play_composition`（fluidsynth 预览）

从 v0.5.0 开始，渲染在服务器端运行 — 无需安装 Csound。证明：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 小节中速摇摆。”
渲染 — “以 120 的速度从指挥结果渲染音频。”
评判 — “播放音频；评判声部引导和音区平衡；建议一项修改。”

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

托管与本地边界

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

安装

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

Claude 桌面 / 网页 / 移动端 — 托管（一键自定义连接器，无需安装任何内容）： 设置 → 连接器 → 添加自定义连接器 → 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 桌面版（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`	（无）	持有者令牌（`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）；它们的源代码不再包含在此包中。