THIRI Chord Intelligence MCP Server

официальный

Детерминированный музыкально-теоретический движок для ИИ-агентов, позволяющий анализировать, разрешать, голосоводить и перегармонизовывать аккорды.

GitHub

Документация

🎷 THIRI Chord Intelligence — MCP-сервер

Дайте вашему ИИ настоящую теорию музыки. THIRI — это детерминированный MCP-сервер + API теории музыки для разработчиков ИИ, который позволяет Claude, Cursor или любому MCP-агенту анализировать аккорды, выполнять анализ по римским цифрам, генерировать голосоведения и регармонизировать последовательности с ответами, которые вычисляются, а не угадываются.

Большие языковые модели галлюцинируют в теории музыки: неправильные ноты, фальшивые римские цифры, голосоведения без голосоведения. THIRI — это детерминированный движок (теория множеств классов высоты тона над ℤ/12), стоящий за хостинговым API, поэтому C7sus4 сохраняет задержание, Caug правильно записывает C E G#, а «Coltrane changes на Dm7 G7 Cmaj7» каждый раз возвращает Cmaj7 Ab7 Abmaj7 E7.

Работаете после Suno / Udio или любого генератора? Оберните вывод и получите корректную аккордовую схему, которой ваш агент может доверять. И в отличие от tonal.js или music21, THIRI является хостинговым и нативно-агентным (без установки, на любом языке) — и он регармонизирует и ведет голоса, а не просто ищет аккорды.

⭐ Если это полезно, поставьте звезду репозиторию — это поможет другим музыкантам и разработчикам агентов найти его.

Что можно спросить

«Проанализируй Dm7b5 в до мажоре.» → iiø7, полууменьшенный, заимствованная преобладающая функция, + варианты гамм «Какие ноты в C7sus4?» → C F G Bb (задержание сохраняется) «Дай мне безосновное голосоведение Cmaj7, затем веди голос в Dm7.» → голосоведения + оценка голосоведения «Регармонизируй Dm7 G7 Cmaj7 с помощью Coltrane changes.» → 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`	Управление группой на естественном языке → дорожки + MIDI (хостинговый MCP v0.3+)

Работает на сетевом движке v2 — корректные sus-аккорды, настоящие трезвучия, энгармоническое написание, все альтерированные доминанты — с тайм-аутами запросов, отчетностью по квотам и структурированными ошибками.

Локальный Csound MCP (только для десктопа)

Для hear-it циклов агента (управление → партитура 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 · рецепты агентов.

Агент-дирижер (vibe compose)

Сквозная персона для локальной vibe-композиции — навык, CLI и панель Band dashboard:

Вход	Команда / путь
Навык 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
Лабораторное доказательство	build.thiri.ai/lab/conductor-agent

Двойная конфигурация MCP выше + mapConductResultToStudioModules после каждого conduct_band. Последний рендер CLI записывает ~/.thiri/conductor-last.json (только локально, не коммитится).

Флагманский рецепт агента (анализ → управление → рендер → критика)

Вставьте по порядку после двойной конфигурации MCP выше:

Анализ — «Проанализируй Dm7 G7 Cmaj7 в тональности до мажор с помощью analyze_chord; суммируй римские цифры и напряжение.»
Управление — «conduct_band: теплый Rhodes pad, шагающий бас, щеточные барабаны, 8 тактов среднего свинга в до мажоре.»
Рендер — «build_csound_score из дорожек, затем render_csound_wav в темпе 120.»
Критика — «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`	Базовый URL API (переопределяйте только для локальной разработки)

Разработка

npm install && npm run build && npm start