THIRI Chord Intelligence

公式

AIエージェントがコードを分析、解決、ボイシング、リハーモナイズするための決定論的音楽理論エンジン。

THIRI Chord Intelligence MCPで何ができますか？

音楽理論でコードを分析 — analyze_chord でルート、品質、音程、ローマ数字、和声機能を尋ねます。セカンダリードミナントやモーダルインターチェンジも含みます。
コード表記を解決 — resolve_chord で異名同音的に正しい音符、周波数、MIDI、スケール推奨を取得します。例：「C7sus4 の構成音は？」
楽器対応のボイシングを生成 — generate_voicing でルートレス、シェル、トライアド、ドロップ2ボイシングをリクエストします。必要に応じて previousNotes を渡し、ボイスリーディングのスコアを算出します。
プログレッションをリハーモナイズ — reharmonize で tritone_sub、coltrane_changes、auto などのテクニックを適用します。例：「Dm7 G7 Cmaj7 をコルトレーン・チェンジでリハーモナイズして。」
自然言語でバンドを指揮 — conduct_band を使って「温かいローズパッド、ウォーキングベース、ブラシドラム」のような説明をレーンとMIDIに変換します。

ドキュメント

🎷 THIRI Chord Intelligence — MCPサーバー

あなたのAIに本物の音楽理論を。 THIRIは、AIビルダーのための決定論的な音楽理論MCPサーバー＋APIです。Claude、Cursor、または任意のMCPエージェントがコード分析、ローマ数字分析、ボイシング生成、プログレッションのリハーモナイズを、推測ではなく計算された答えで実行できるようにします。

LLMは音楽理論に関して幻覚を起こします。間違った音、偽のローマ数字、ボイスリーディングが機能しないボイシングなどです。THIRIは、ホスト型APIの背後にある決定論的エンジン（ℤ/12上のピッチクラス集合理論）です。そのため、C7sus4はサスペンションを維持し、CaugはC E G#を正しく表記し、「Dm7 G7 Cmaj7にコルトレーン・チェンジ」は毎回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に質問: 「Dm7 G7 Cmaj7をコルトレーン・チェンジでリハーモナイズして。」

これだけです。インストールも設定ファイルも不要です。ビルダー向けの完全なインストールオプション（Claude Code、デスクトップ設定、生のHTTP）は下記にあります。

質問できること

「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`	楽器対応ボイシング（ルートレス/bill_evans、シェル、トライアド、パッド、ガイドトーン、ドロップ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再生）の場合、ホスト型理論ツールと並べて2つ目のローカルサーバーを追加します:

{
  "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 → Vibe Conductパネル
ラボでの証明	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でconduct結果からrender_audio。」
批評 — 「play_audio; ボイスリーディングとレジスターのバランスを批評して。1つの改訂を提案して。」

完全なプロンプト: 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 / web / mobile — ホスト型（ワンクリックカスタムコネクタ、インストール不要）: 設定 → コネクタ → カスタムコネクタを追加 → URL https://mcp.thiri.ai/mcp → 同意ページでsk_live_キーを貼り付け。同じ5つのツール、同じキー、同じクォータ — 設定ファイルもnpxも不要です。

Claude Code（1行）:

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"}'

5つのエンドポイント: /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）。これらのソースコードはこのパッケージには同梱されなくなりました。