THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — MCP सर्वर

अपने AI को वास्तविक संगीत सिद्धांत दें। THIRI AI बिल्डरों के लिए नियतात्मक संगीत सिद्धांत MCP सर्वर + API है — यह Claude, Cursor, या किसी भी MCP एजेंट को कॉर्ड विश्लेषण, रोमन-अंक विश्लेषण, वॉइसिंग उत्पन्न करना, और प्रगति को पुनः-सामंजस्यित करना की अनुमति देता है, जिसके उत्तर गणना किए गए होते हैं, अनुमानित नहीं।

LLM संगीत सिद्धांत में भ्रम पैदा करते हैं: गलत नोट, नकली रोमन अंक, ऐसी वॉइसिंग जो वॉइस-लीड नहीं करती। THIRI एक नियतात्मक इंजन है (पिच-क्लास-सेट सिद्धांत ℤ/12 पर) जो एक होस्टेड API के पीछे है — इसलिए C7sus4 अपना सस्पेंशन बनाए रखता है, Caug C E G# की वर्तनी करता है, और "Coltrane changes on Dm7 G7 Cmaj7" हर बार Cmaj7 Ab7 Abmaj7 E7 लौटाता है।

Suno / Udio या किसी भी जनरेटर के डाउनस्ट्रीम? आउटपुट को लपेटें और एक सही कॉर्ड चार्ट प्राप्त करें जिस पर आपका एजेंट भरोसा कर सके। और tonal.js या music21 के विपरीत, THIRI होस्टेड और एजेंट-नेटिव है (कोई इंस्टॉल नहीं, कोई भी भाषा) — और यह पुनः-सामंजस्य और वॉइस-लीड करता है, केवल कॉर्ड देखने के बजाय।

⭐ यदि यह उपयोगी है, तो रेपो को स्टार करें — यह अन्य संगीतकारों और एजेंट बिल्डरों को इसे खोजने में मदद करता है।

👥 पहले 55 AI संगीत बिल्डरों से जुड़ें: उन्नत दर सीमाएँ (300 req/min), सीधा संस्थापक समर्थन, और आगामी टूल तक प्रारंभिक पहुँच चाहते हैं? हमारे डेवलपर समुदाय में Skool — Blues People AI पर शामिल हों।

संगीतकार: 2-मिनट सेटअप (कोई कोड नहीं)

1. build.thiri.ai/developers पर एक मुफ्त कुंजी प्राप्त करें
2. Claude में: Settings → Connectors → Add custom connector → URL https://mcp.thiri.ai/mcp → अपनी sk_live_ कुंजी पेस्ट करें
3. Claude से पूछें: "Reharmonize Dm7 G7 Cmaj7 with Coltrane changes."

बस इतना ही — कोई इंस्टॉल नहीं, कोई कॉन्फ़िग फ़ाइल नहीं। बिल्डरों के लिए: पूर्ण इंस्टॉल विकल्प (Claude Code, Desktop config, raw HTTP) नीचे हैं।

आप क्या पूछ सकते हैं

"Analyze Dm7b5 in C." → iiø7, half-diminished, उधार लिया गया predominant, + स्केल विकल्प "What notes are in C7sus4?" → C F G Bb (सस्पेंशन बच जाता है) "Give me a rootless Cmaj7 voicing, then voice-lead into Dm7." → वॉइसिंग + एक वॉइस-लीडिंग स्कोर "Reharmonize Dm7 G7 Cmaj7 with Coltrane changes." → Cmaj7 Ab7 Abmaj7 E7

टूल

टूल	यह क्या करता है
analyze_chord	कॉर्ड → रूट, गुणवत्ता, अंतराल, रोमन अंक और हार्मोनिक फ़ंक्शन (सेकेंडरी डोमिनेंट, मोडल-इंटरचेंज लेबल)
resolve_chord	कॉर्ड → वर्तनी वाले नोट (एनहार्मोनिक रूप से सही), आवृत्तियाँ, MIDI, स्केल अनुशंसाएँ
generate_voicing	इंस्ट्रूमेंट-तैयार वॉइसिंग (rootless/bill_evans, shell, triad, 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 कॉर्ड, वास्तविक त्रय, एनहार्मोनिक वर्तनी, सभी परिवर्तित डोमिनेंट — अनुरोध टाइमआउट, कोटा रिपोर्टिंग, और संरचित त्रुटियों के साथ।

कंडक्टर और रचना साथी (केवल डेस्कटॉप)

सुनने-योग्य एजेंट लूप के लिए (कंडक्ट → सर्वर-साइड रेंडर → आपके स्पीकर के माध्यम से 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 (सर्वर-साइड Csound POST /v2/render के माध्यम से), 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 · एजेंट रेसिपी।

कंडक्टर एजेंट (vibe compose)

स्थानीय vibe रचना के लिए एंड-टू-एंड व्यक्तित्व — कौशल, 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 Dm7 G7 Cmaj7 in key C with analyze_chord; summarize roman numerals and tension."
2. कंडक्ट — "conduct_band: warm Rhodes pad, walking bass, brush drums, 8 bars medium swing in C."
3. रेंडर — "render_audio from the conduct result at tempo 120."
4. आलोचना — "play_audio; critique voice-leading and register balance; suggest one revision."

पूर्ण प्रॉम्प्ट: build.thiri.ai/lab/agent-recipes

होस्टेड बनाम स्थानीय सीमा

सतह	ऑडियो रेंडर
mcp.thiri.ai / होस्टेड कनेक्टर	नहीं — केवल सिद्धांत + conduct_band लेन
स्थानीय thiri-conductor-mcp	हाँ — WAV सर्वर-साइड रेंडर किया गया (POST /v2/render), स्थानीय रूप से चलाया गया; कोई Csound इंस्टॉल आवश्यक नहीं

इंस्टॉल

build.thiri.ai/developers पर एक मुफ्त कुंजी प्राप्त करें, फिर एक पथ चुनें:

Claude Desktop / web / mobile — होस्टेड (एक-क्लिक कस्टम कनेक्टर, इंस्टॉल करने के लिए कुछ नहीं): Settings → Connectors → Add custom connector → 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/developers पर एक प्राप्त करें
THIRI_API_URL	https://chords.thiri.ai	API आधार (केवल स्थानीय विकास के लिए ओवरराइड करें)

विकास

npm install && npm run build && npm start

लाइसेंस

PolyForm Noncommercial 1.0.0 — © 2026 Blues Prince Media। व्यक्तिगत, अनुसंधान, और गैर-वाणिज्यिक उपयोग के लिए मुफ्त; वाणिज्यिक उपयोग के लिए लाइसेंस की आवश्यकता है (dennison@bluesprincemedia.com)। LICENSE देखें। v0.5.0 या उससे पहले प्रकाशित संस्करण उनके साथ भेजे गए MIT/PolyForm दोहरे लाइसेंस के अंतर्गत रहते हैं।

v0.5.0 के अनुसार रचना इंजन और Csound रेंडरर होस्टेड API के पीछे सर्वर-साइड चलते हैं (POST /v2/compose, POST /v2/render); उनका स्रोत अब इस पैकेज में नहीं भेजा जाता।