THIRI Chord Intelligence

🎷 THIRI Chord Intelligence — MCP सर्वर

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

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

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

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

👥 AI संगीत निर्माताओं से जुड़ें: उन्नत दर सीमाएँ, सीधा संस्थापक समर्थन, और आगामी उपकरणों तक प्रारंभिक पहुँच चाहते हैं? हमारे डेवलपर समुदाय में Skool — T.H.I.R.I. Builders पर शामिल हों।

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

1. build.thiri.ai/keys पर एक मुफ्त कुंजी प्राप्त करें
2. Claude में: सेटिंग्स → कनेक्टर → कस्टम कनेक्टर जोड़ें → URL https://mcp.thiri.ai/mcp → अपनी sk_live_ कुंजी पेस्ट करें
3. Claude से पूछें: "Dm7 G7 Cmaj7 को Coltrane परिवर्तनों के साथ पुनः-सामंजस्य करें।"

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

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

"C में Dm7b5 का विश्लेषण करें।" → iiø7, अर्ध-क्षीण, उधार प्रमुख, + स्केल विकल्प "C7sus4 में कौन से स्वर हैं?" → C F G Bb (निलंबन बच जाता है) "मुझे एक रूटलेस Cmaj7 वॉइसिंग दें, फिर Dm7 में वॉइस-लीड करें।" → वॉइसिंग + एक वॉइस-लीडिंग स्कोर "Dm7 G7 Cmaj7 को Coltrane परिवर्तनों के साथ पुनः-सामंजस्य करें।" → Cmaj7 Ab7 Abmaj7 E7

उपकरण

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

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

सुनने-योग्य एजेंट लूप के लिए (निर्देश → सर्वर-साइड रेंडर → आपके स्पीकर के माध्यम से 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 via 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 पैनल
Lab प्रमाण	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 पैड, चलने वाला बास, ब्रश ड्रम, C में 8 बार मध्यम स्विंग।"
3. रेंडर — "conduct परिणाम से 120 टेम्पो पर render_audio।"
4. आलोचना — "play_audio; वॉइस-लीडिंग और रजिस्टर संतुलन की आलोचना करें; एक संशोधन सुझाएँ।"

पूर्ण प्रॉम्प्ट: 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 / वेब / मोबाइल — होस्टेड (एक-क्लिक कस्टम कनेक्टर, इंस्टॉल करने के लिए कुछ नहीं): सेटिंग्स → कनेक्टर → कस्टम कनेक्टर जोड़ें → 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/keys पर प्राप्त करें
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); उनका स्रोत अब इस पैकेज में शामिल नहीं है।