Thiri Chord Intelligence — Music Theory Mcp Server

🎷 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 Music Builders に参加する：レート制限の緩和、創業者による直接サポート、今後公開予定のツールへの早期アクセスをご希望ですか？Skool — T.H.I.R.I. Builders の開発者コミュニティにご参加ください。

ミュージシャン向け：2分でセットアップ（コード不要）

1. build.thiri.ai/keys で無料キーを取得します
2. Claude で、Settings → Connectors → Add custom connector を開き、URL https://mcp.thiri.ai/mcp を入力して、sk_live_ キーを貼り付けます
3. Claude にこう尋ねます：「Dm7 G7 Cmaj7 をコルトレーン・チェンジでリハーモナイズして。」

これだけです。インストールも設定ファイルも必要ありません。開発者向けの全インストール方法（Claude Code、Desktop の設定、raw 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 グリッドエンジンで動作します。正確なサスコード、本物のトライアド、異名同音の綴り、あらゆるオルタード・ドミナントに対応し、リクエストのタイムアウト、クォータの報告、構造化されたエラーも備えています。

Conductor と作曲コンパニオン（デスクトップのみ）

hear-it エージェントのループ（指揮 → サーバーサイドレンダリング → スピーカーから WAV を再生）には、ホスト型の理論ツールに加えて、ローカルサーバーをもう 1 つ追加します。

{
  "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 · エージェントのレシピ。

Conductor Agent（バイブ作曲）

ローカルでのバイブ作曲をエンドツーエンドで実現するペルソナです。スキル、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 設定の後に、順番に貼り付けてください。

1. 分析 — 「analyze_chord を使って、キー C の Dm7 G7 Cmaj7 を分析し、ローマ数字とテンションを要約してください。」
2. 指揮 — 「conduct_band：温かみのある Rhodes パッド、ウォーキングベース、ブラシドラム、中程度のスウィングで 8 小節、キー C。」
3. レンダリング — 「指揮の結果を使い、テンポ 120 で render_audio を実行してください。」
4. 批評 — 「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 — ホスト型（ワンクリックのカスタムコネクター。インストール不要）： Settings → Connectors → Add custom connector → 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 のベース URL（ローカル開発時のみ上書き）

開発

npm install && npm run build && npm start

ライセンス

PolyForm Noncommercial 1.0.0 — © 2026 Blues Prince Media。個人利用、 研究、非商用利用は無料です。商用利用にはライセンスが必要です （[email protected]）。LICENSE をご覧ください。v0.5.0 以前に 公開されたバージョンには、公開時に適用されていた MIT/PolyForm デュアルライセンスが引き続き適用されます。

v0.5.0 以降、作曲エンジンと Csound レンダラーはホスト型 API（POST /v2/compose、POST /v2/render）の背後で サーバーサイド実行されます。そのソースコードは、このパッケージに含まれなくなりました。