सामग्री पर जाएँ

MCP API संदर्भ

Maguyva के 11 MCP टूल्स, उनके पैरामीटर और उपयोग के सही समय के बारे में जानें। आपके लिए उपलब्ध आर्ग्युमेंट देखने के लिए कनेक्टेड क्लाइंट का tools/list रिस्पॉन्स जाँचें।

API अवलोकन

#

टूल्स को 4 श्रेणियों में रखा गया है:

  • मुख्य सर्च टूल्स - आपके कोडबेस में उन्नत सर्च क्षमताएँ
  • स्ट्रक्चरल और ग्राफ़ टूल्स - AST क्वेरी, सिंबल लुकअप, और डिपेंडेंसी विश्लेषण
  • कोड विश्लेषण टूल्स - गहन कोड विश्लेषण और संबंध मैपिंग
  • सिस्टम और यूटिलिटी टूल्स - रिपॉज़िटरी संदर्भ, टूल संबंधी मार्गदर्शन और प्रतिक्रिया

रिपॉज़िटरी स्वीकार करने वाले टूल्स में यह रिपॉज़िटरी आइडेंटिफ़ायर फ़ॉर्मैट इस्तेमाल करें: "owner/repo:branch"। ब्रांच न बताने पर डिफ़ॉल्ट main होता है।

जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो repository छोड़ दें; अन्यथा इसे स्पष्ट रूप से पास करें। कोई रिपॉज़िटरी कैसे रिज़ॉल्व होती है, यह देखने के लिए repository_context(action="info", repository="owner/repo") उपयोग करें।

रिपॉज़िटरी पैरामीटर फ़ॉर्मैट

#

रिपॉज़िटरी बताते समय ये फ़ॉर्मैट इस्तेमाल करें:

  • ब्रांच के साथ: "owner/repo:branch" - उदा., "owner/repository:develop"
  • डिफ़ॉल्ट ब्रांच: "owner/repo" - अगर ब्रांच निर्दिष्ट नहीं है तो main ब्रांच इस्तेमाल होती है "owner/repository"
  • रिक्वेस्ट डिफ़ॉल्ट या एकमात्र रिपॉज़िटरी डिफ़ॉल्ट: जब MCP क्लाइंट रिक्वेस्ट के लिए डिफ़ॉल्ट देता हो या कुंजी केवल एक ही रिपॉज़िटरी एक्सेस कर सकती हो, तब repository छोड़ दें; अन्यथा इसे स्पष्ट रूप से पास करें।

उदाहरण प्रॉम्प्ट:

किसी विशिष्ट रिपॉज़िटरी के बारे में पूछें:  "owner/my-repo में प्रमाणीकरण middleware खोजें"
उपलब्ध रिपॉज़िटरी सूची देखें:               "यह Maguyva कुंजी किन रिपॉज़िटरी को एक्सेस कर सकती है?"
एक क्वेरी के लिए ओवरराइड करें:              "owner/other-repo:develop में प्रमाणीकरण पैटर्न खोजें"

भाषा फ़िल्टरिंग

#

समर्थित खोज मोड में language_filter इस्तेमाल करें। text_pattern_search के लिए search_scope="content" चुनें; get_task_context के लिए शुरुआती बिंदुओं या संबंधित संदर्भ के बिना scope="semantic" इस्तेमाल करें।

  • language_filter="python" - केवल Python फ़ाइलों तक सीमित करें
  • language_filter="typescript" - केवल TypeScript फ़ाइलों तक सीमित करें
  • केस-सेंसिटिव: लोअरकेस भाषा नामों का इस्तेमाल करें
  • डिफ़ॉल्ट: ख़ाली स्ट्रिंग (कोई फ़िल्टरिंग नहीं) - सभी भाषाओं से रिज़ल्ट लौटाता है
  • समर्थित कवरेज: भाषा फ़िल्टर पूरे 285+ समर्थित भाषाएँ और टेक्स्ट-आधारित तकनीकें में काम करते हैं। पूरी सूची के लिए संगतता देखें। 
"केवल Python फ़ाइलों में ऑथेंटिकेशन मिडलवेयर ढूँढें"
"TypeScript में डेटाबेस कनेक्शन सर्च करें"

API संदर्भ 21 अक्टूबर 2026 को सोर्स से जनरेट किया गया।

मुख्य खोज टूल

#

intelligent_search स्टेबल

कोडबेस के बारे में किसी भी प्रश्न के लिए यहाँ से शुरू करें। डिफ़ॉल्ट auto/balanced जिन प्रश्नों को उच्च विश्वास के साथ परिभाषा खोज के रूप में पहचानता है, उन्हें संरचनात्मक खोज पर, संदर्भ या प्रभाव से जुड़े प्रश्नों को ग्राफ़ पर और सटीक मिलान वाले प्रश्नों को टेक्स्ट खोज पर भेजता है। अन्य प्रश्न अर्थ-आधारित खोज और इंडेक्स किए गए टेक्स्ट का उपयोग करते हैं। खोज की चारों विधियाँ माँगने के लिए mode=hybrid या quality=thorough के साथ auto का उपयोग करें। स्पष्ट रूप से चुने गए mode को quality पर प्राथमिकता मिलती है। language_filter, auto/hybrid से ग्राफ़ को हटा देता है और स्पष्ट रूप से mode=graph चुने जाने पर अस्वीकार कर दिया जाता है। जब आपको पाथ पहले से न पता हो, तो Grep/Glob के बजाय इसे प्राथमिकता दें।

पैरामीटर:

query आवश्यक
टाइप
str minLength=1
विवरण
खोज क्वेरी
repository वैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। पूरी तरह मेल खाने वाली इंडेक्स्ड ब्रांच को प्राथमिकता दी जाती है; अनुपलब्ध ब्रांच के मामले में main या एकमात्र सुलभ ब्रांच पर वापस जाया जा सकता है। प्रतिक्रिया के मेटाडेटा में अनुरोधित और वास्तव में उपयोग की गई पहचान दिखती है, और ऐसा होने पर चेतावनी दी जाती है।
mode वैकल्पिक
टाइप
Literal[auto, hybrid, semantic, text, structural, ast, graph]
डिफ़ॉल्ट
auto
विवरण
खोज मोड
limit वैकल्पिक
टाइप
int minimum=1, maximum=50
डिफ़ॉल्ट
10
विवरण
इस रैंक किए गए top-K विंडो में अधिकतम परिणाम
language_filter वैकल्पिक
टाइप
str
विवरण
भाषा फ़िल्टर
path_filter वैकल्पिक
टाइप
str
विवरण
फ़ाइल पाथ प्रीफ़िक्स के अनुसार खोज के उम्मीदवारों को फ़िल्टर करता है। ग्राफ़ के पड़ोसी नोड और संलग्न समुदाय संदर्भ में इस प्रीफ़िक्स के बाहर की फ़ाइलें शामिल हो सकती हैं।
boost_by_importance वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
वैकल्पिक: प्रति-सिंबल ग्राफ़ मेट्रिक्स (is_articulation_point, bridge_count, k_core, centrality, आदि) का उपयोग करते हुए centrality के अनुसार पुनः रैंक करें। एजेंट-सुरक्षित रैंकिंग के लिए डिफ़ॉल्ट रूप से बंद (ग्लोबल हब कार्यान्वयन परिणामों को दबा सकते हैं); आर्किटेक्चर टूर के लिए सक्षम करें। जब प्रत्येक परिणाम सिंबल लिंकेज रखता है तब सभी 4 मोडैलिटी पर लागू होता है।
branch वैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
quality वैकल्पिक
टाइप
Literal[quick, balanced, thorough]
डिफ़ॉल्ट
balanced
विवरण
सर्च गुणवत्ता प्रीसेट
include_content वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
true
विवरण
परिणामों में कंटेंट शामिल करें
explain_routing वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
राउटिंग निर्णय की व्याख्या शामिल करें
importance_weight वैकल्पिक
टाइप
float minimum=0, maximum=1
डिफ़ॉल्ट
0.3
विवरण
महत्त्व के आधार पर बूस्ट का वज़न (0=कोई बूस्ट नहीं, 1=पूरा)
orphans वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
ऑर्फ़न सिंबल शामिल करें (कोई इनकमिंग रेफरेंस नहीं)
include_community_context वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
इसी कोड समुदाय के संबंधित सिंबल शामिल करें
community_depth वैकल्पिक
टाइप
int minimum=1, maximum=3
डिफ़ॉल्ट
1
विवरण
समुदाय संदर्भ विस्तार की गहराई
graph_view वैकल्पिक
टाइप
Literal[dependency, type, data_flow, control_flow]
डिफ़ॉल्ट
dependency
विवरण
मेट्रिक्स के लिए graph view
seed_symbol_ids वैकल्पिक
टाइप
list[str] maxItems=20
विवरण
Tier-1 टास्क सीड: वर्तमान काम के केंद्र में मौजूद सिंबल ID। सेट करने पर, Approach A की गहराई बढ़ने के साथ घटती निकटता (सीड का सटीक मिलान + ग्राफ़-एज हॉप) के आधार पर संयुक्त नतीजों को दोबारा रैंक करता है। यह अतिरिक्त विकल्प है; वैश्विक रैंकिंग के लिए इसे छोड़ दें।
seed_file_paths वैकल्पिक
टाइप
list[str] maxItems=10
विवरण
Tier-1 टास्क सीड: वे इंडेक्स्ड फ़ाइल पाथ जिन्हें एजेंट ने खोल रखा है या अभी एडिट किया है। सेट करने पर, पाथ की निकटता और 1/(1+d) के अनुसार गहराई के साथ घटते वज़न से संयुक्त नतीजों को दोबारा रैंक करता है (एक ही फ़ाइल → एक ही डायरेक्टरी → पास के पैकेज)। यह अतिरिक्त विकल्प है; वैश्विक रैंकिंग के लिए इसे छोड़ दें।

इसके लिए सबसे उपयुक्त:

  • पूरे इंडेक्स में या शुरुआती खोज जब सही टूल स्पष्ट न हो
  • सिमैंटिक, टेक्स्ट, स्ट्रक्चरल और ग्राफ़ पर मल्टी-मोडल संयुक्त रैंकिंग

इसके लिए अनुशंसित नहीं:

  • ज्ञात सिंबल नाम — सीधे find_symbol का उपयोग करें
  • डिस्क पर ज्ञात पाथ — पहले लोकल Read/Grep का उपयोग करें

semantic_search स्टेबल

सटीक पाठ के बजाय अर्थ से कोड खोजें। कीवर्ड या सिंबल का नाम ज्ञात न हो तो 'दोबारा प्रयास का तर्क' या 'नए उपयोगकर्ता की शुरुआत का प्रवाह' जैसे वैचारिक प्रश्नों के लिए उपयोग करें। फ़ाइलों की विविधता की सीमा के साथ प्रासंगिक अंश लौटाता है; ग्राफ़ में महत्त्व के आधार पर दोबारा क्रम देना boost_by_importance से वैकल्पिक रूप से चालू होता है। वैचारिक खोज में Grep के बजाय इसे चुनें।

पैरामीटर:

query आवश्यक
टाइप
str minLength=1
विवरण
खोज क्वेरी (वैचारिक, अर्थ-आधारित)
repository वैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। पूरी तरह मेल खाने वाली इंडेक्स्ड ब्रांच को प्राथमिकता दी जाती है; अनुपलब्ध ब्रांच के मामले में main या एकमात्र सुलभ ब्रांच पर वापस जाया जा सकता है। प्रतिक्रिया के मेटाडेटा में अनुरोधित और वास्तव में उपयोग की गई पहचान दिखती है, और ऐसा होने पर चेतावनी दी जाती है।
limit वैकल्पिक
टाइप
int minimum=1, maximum=50
डिफ़ॉल्ट
5
विवरण
इस रैंक किए गए top-K विंडो में अधिकतम परिणाम
similarity_threshold वैकल्पिक
टाइप
float minimum=0, maximum=1
डिफ़ॉल्ट
0.6
विवरण
न्यूनतम समानता स्कोर
language_filter वैकल्पिक
टाइप
str
विवरण
भाषा फ़िल्टर (python, typescript, आदि)
path_filter वैकल्पिक
टाइप
str
विवरण
फ़ाइल पाथ प्रीफ़िक्स से फ़िल्टर करें
boost_by_importance वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
वैकल्पिक: प्रत्येक सिंबल के सामान्यीकृत ग्राफ़ महत्त्व के आधार पर दोबारा क्रम देता है (डिफ़ॉल्ट बंद; समानता के 1.5 गुने तक सीमित)।
branch वैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड (डिफ़ॉल्ट: repository पैराम या main)
include_content वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
true
विवरण
परिणामों में चंक कंटेंट शामिल करें
graph_view वैकल्पिक
टाइप
Literal[dependency, type, data_flow, control_flow]
डिफ़ॉल्ट
dependency
विवरण
मेट्रिक्स के लिए graph view

इसके लिए सबसे उपयुक्त:

  • वैचारिक क्वेरी ('ऑथेंटिकेशन कैसे काम करता है?', 'कैशिंग रणनीति')
  • पैकेजों के बीच समानता खोज

इसके लिए अनुशंसित नहीं:

  • ज्ञात सिंबल नाम — इसके बजाय find_symbol का उपयोग करें
  • सटीक स्ट्रिंग या एरर संदेश — text_pattern_search का उपयोग करें

text_pattern_search स्टेबल

इंडेक्स की गई सामग्री खोजें। exact और regex पूरे फ़ाइल/blob संग्रह पर grep चलाते हैं; fuzzy content सीमित सिमैंटिक अंश-संग्रह में खोजता है। file और symbol स्कोप केवल ट्राइग्राम इस्तेमाल करते हैं — डिफ़ॉल्ट mode=exact को fuzzy में बदला जाता है। भाषा, अक्षर-केस और कस्टम थ्रेशोल्ड नियंत्रण के लिए content स्कोप चाहिए। फ़ाइल पथ फ़िल्टर सीमित उम्मीदवार विंडो इस्तेमाल करता है और अधूरी कवरेज बताता है। डिस्क पर पहले से मौजूद छोटे दायरे वाली डायरेक्टरी के लिए स्थानीय Grep इस्तेमाल करें।

पैरामीटर:

query आवश्यक
टाइप
str minLength=1
विवरण
खोजने के लिए टेक्स्ट पैटर्न
repository वैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। पूरी तरह मेल खाने वाली इंडेक्स्ड ब्रांच को प्राथमिकता दी जाती है; अनुपलब्ध ब्रांच के मामले में main या एकमात्र सुलभ ब्रांच पर वापस जाया जा सकता है। प्रतिक्रिया के मेटाडेटा में अनुरोधित और वास्तव में उपयोग की गई पहचान दिखती है, और ऐसा होने पर चेतावनी दी जाती है।
mode वैकल्पिक
टाइप
Literal[fuzzy, exact, regex]
डिफ़ॉल्ट
exact
विवरण
खोज मोड। Regex, PostgreSQL के advanced/POSIX सिंटैक्स को निष्पादित करता है; शब्द सीमाओं के लिए \y का उपयोग करें (\b का अर्थ है बैकस्पेस)। पैटर्न एक JavaScript सुरक्षा वैलिडेटर से भी गुज़रते हैं, इसलिए इनलाइन (?i) फ़्लैग जैसे केवल-PostgreSQL निर्माण अस्वीकृत कर दिए जाते हैं; इसके बजाय case_sensitive का उपयोग करें।
search_scope वैकल्पिक
टाइप
Literal[content, symbols, files]
डिफ़ॉल्ट
content
विवरण
क्या खोजें
limit वैकल्पिक
टाइप
int minimum=1, maximum=50
डिफ़ॉल्ट
5
विवरण
cursor का उपयोग न करने पर प्रति पेज अधिकतम परिणाम। जारी रखने पर cursor में संग्रहीत पेज साइज़ का उपयोग होता है; अलग limit से शुरू करने के लिए cursor छोड़ें।
offset वैकल्पिक
टाइप
int minimum=0
विवरण
पुरानी संगतता के लिए रखा गया, अब अनुशंसित नहीं: offset। pagination.next_cursor से मिले cursor को प्राथमिकता दें।
cursor वैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से मिला ओपेक cursor। इसे बिना बदले पास करें और query तथा फ़िल्टर को अपरिवर्तित रखें। इसकी स्थिति और पेज साइज़ को offset और limit पर प्राथमिकता मिलती है।
language_filter वैकल्पिक
टाइप
str
विवरण
भाषा फ़िल्टर
path_filter वैकल्पिक
टाइप
str
विवरण
फ़ाइल पाथ प्रीफ़िक्स द्वारा फ़िल्टर करें
case_sensitive वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
केस-सेंसिटिव मिलान
branch वैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
fuzzy_algorithm वैकल्पिक
टाइप
Literal[hybrid, trigram, levenshtein]
डिफ़ॉल्ट
hybrid
विवरण
फज़ी मिलान एल्गोरिद्म
threshold वैकल्पिक
टाइप
float minimum=0, maximum=1
डिफ़ॉल्ट
0.05
विवरण
फज़ी के लिए न्यूनतम समानता थ्रेशोल्ड
semantic_fallback वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
पहला लेक्सिकल पेज खाली होने पर सिमेंटिक सर्च आज़माता है; metadata.fallback_status used, empty और unavailable फ़ॉलबैक स्थितियों के बीच अंतर करता है।

इसके लिए सबसे उपयुक्त:

  • सटीक स्ट्रिंग, एरर संदेश और रेगेक्स
  • लगभग-मेल खाते टेक्स्ट के लिए ट्राइग्राम फ़ज़ी मैचिंग

इसके लिए अनुशंसित नहीं:

  • डिस्क पर ज्ञात पाथ — लोकल Grep को प्राथमिकता दें
  • वैचारिक क्वेरी — semantic_search का उपयोग करें

संरचनात्मक और ग्राफ़ टूल

#

structural_search स्टेबल

preset=functions|classes|methods|imports|variables (या स्वतंत्र pattern=) को प्राथमिकता दें। टेक्स्ट के बजाय AST संरचना के आधार पर कोड खोजें। मध्य-स्तरीय फ़िल्टर: name_pattern, node_type, decorator, parent_child। पाथ/ltree/कॉल फ़िल्टर उन्नत हैं; उन्हें जानबूझकर इस्तेमाल करते समय advanced=true सेट करें। इसके बिना भी उन्नत फ़िल्टर लागू होते हैं, लेकिन मेटाडेटा में चेतावनी मिलती है। कम-से-कम एक संरचनात्मक चयनकर्ता दें।

पैरामीटर:

repository वैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। पूरी तरह मेल खाने वाली इंडेक्स्ड ब्रांच को प्राथमिकता दी जाती है; अनुपलब्ध ब्रांच के मामले में main या एकमात्र सुलभ ब्रांच पर वापस जाया जा सकता है। प्रतिक्रिया के मेटाडेटा में अनुरोधित और वास्तव में उपयोग की गई पहचान दिखती है, और ऐसा होने पर चेतावनी दी जाती है।
preset वैकल्पिक
टाइप
Literal[functions, classes, methods, imports, variables]
विवरण
पसंदीदा संरचनात्मक चयनकर्ता। क्रॉस-लैंग्वेज AST नोड प्रकारों में विस्तृत होता है — functions (भाषाओं में function/arrow/method परिभाषाएँ); classes (class/struct/interface घोषणाएँ, टाइप बॉडी और कार्यान्वयन); methods (method परिभाषाएँ (और जिन भाषाओं में method नोड नहीं है उनके लिए function_definition)); imports (import/use/include स्टेटमेंट); variables (variable/let/const/static घोषणाएँ)। ब्राउज़-शैली क्वेरी के लिए मुक्त-रूप pattern/node_type के बजाय इसे प्राथमिकता दें।
pattern वैकल्पिक
टाइप
str
विवरण
फ़्री-फ़ॉर्म pattern अनुपस्थित सेलेक्टर को भरता है (ऑटो-डिटेक्ट: 'def foo(' → node_type + name_pattern)। इसे preset के साथ जोड़ा जा सकता है; स्पष्ट सेलेक्टर को प्राथमिकता मिलती है। ब्राउज़ क्वेरीज़ के लिए preset= को प्राथमिकता दें।
name_pattern वैकल्पिक
टाइप
str maxLength=256
विवरण
सिंबल नाम पैटर्न (shell वाइल्डकार्ड, सीमित POSIX regex, या फ़ज़ी टेक्स्ट; अधिकतम 256 वर्ण)
node_type वैकल्पिक
टाइप
str
विवरण
AST नोड प्रकार (function_definition, class_definition, आदि) — सामान्य आकारों के लिए preset= को प्राथमिकता दें
decorator वैकल्पिक
टाइप
str
विवरण
डेकोरेटर नाम फ़िल्टर
base_class वैकल्पिक
टाइप
str
विवरण
बेस क्लास फ़िल्टर (इससे इनहेरिट करने वाली क्लास खोजें)
language_filter वैकल्पिक
टाइप
str
विवरण
भाषा फ़िल्टर (python, typescript, आदि)
limit वैकल्पिक
टाइप
int minimum=1, maximum=50
डिफ़ॉल्ट
20
विवरण
cursor का उपयोग न करने पर प्रति पेज अधिकतम परिणाम। जारी रखने पर cursor में संग्रहीत पेज साइज़ का उपयोग होता है; अलग limit से शुरू करने के लिए cursor छोड़ें।
offset वैकल्पिक
टाइप
int minimum=0
विवरण
पुरानी संगतता के लिए रखा गया, अब अनुशंसित नहीं: offset। pagination.next_cursor से मिले cursor को प्राथमिकता दें।
cursor वैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से मिला ओपेक cursor। इसे बिना बदले पास करें और query तथा फ़िल्टर को अपरिवर्तित रखें। इसकी स्थिति और पेज साइज़ को offset और limit पर प्राथमिकता मिलती है।
path_filter वैकल्पिक
टाइप
str
विवरण
फ़ाइल पाथ प्रीफ़िक्स से फ़िल्टर करें
branch वैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
query_type वैकल्पिक
टाइप
Literal[node_type, name_pattern, parent_child]
विवरण
स्पष्ट क्वेरी प्रकार (डिफ़ॉल्ट ऑटो-डिटेक्शन को ओवरराइड करने के लिए सेट करें)
parent_type वैकल्पिक
टाइप
str
विवरण
पैरेंट AST नोड प्रकार फ़िल्टर
relationship वैकल्पिक
टाइप
Literal[parent, ancestor]
डिफ़ॉल्ट
parent
विवरण
parent_child क्वेरियों के लिए: केवल डायरेक्ट पेरेंट या कोई भी ऐन्सेस्टर (क्लास के अंदर नेस्टेड मेथड के लिए ancestor उपयोग करें)
has_modifier वैकल्पिक
टाइप
str
विवरण
मॉडिफ़ायर से फिल्टर करें (export, async, static, आदि)
advanced वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
उन्नत पाथ/ltree/कॉल फ़िल्टर (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name) जानबूझकर इस्तेमाल करते समय true सेट करें। false होने पर दिए गए उन्नत फ़िल्टर मेटाडेटा चेतावनी के साथ लागू होते हैं। सामान्य संरचनात्मक क्वेरी के लिए preset= को प्राथमिकता दें।
callee_text वैकल्पिक
टाइप
str
विवरण
उन्नत — preset=functions|classes|methods|imports|variables को प्राथमिकता दें। कॉल एक्सप्रेशन callee टेक्स्ट फ़िल्टर। path/ltree/call फ़िल्टर जानबूझकर उपयोग करते समय advanced=true सेट करें।
callee_name वैकल्पिक
टाइप
str
विवरण
उन्नत — preset=functions|classes|methods|imports|variables को प्राथमिकता दें। कॉल एक्सप्रेशन callee नाम फ़िल्टर। path/ltree/call फ़िल्टर जानबूझकर उपयोग करते समय advanced=true सेट करें।
field_role वैकल्पिक
टाइप
str
विवरण
उन्नत — preset=functions|classes|methods|imports|variables को प्राथमिकता दें। AST फ़ील्ड भूमिका फ़िल्टर। path/ltree/call फ़िल्टर जानबूझकर उपयोग करते समय advanced=true सेट करें।
ltree_ancestor वैकल्पिक
टाइप
str
विवरण
उन्नत — preset=functions|classes|methods|imports|variables को प्राथमिकता दें। AST ltree पूर्वज पथ फ़िल्टर। path/ltree/call फ़िल्टर जानबूझकर उपयोग करते समय advanced=true सेट करें।
ltree_descendant वैकल्पिक
टाइप
str
विवरण
उन्नत — preset=functions|classes|methods|imports|variables को प्राथमिकता दें। AST ltree वंशज पथ फ़िल्टर। path/ltree/call फ़िल्टर जानबूझकर उपयोग करते समय advanced=true सेट करें।
definition_name वैकल्पिक
टाइप
str
विवरण
उन्नत — preset=functions|classes|methods|imports|variables को प्राथमिकता दें। परिभाषा नाम फ़िल्टर। path/ltree/call फ़िल्टर जानबूझकर उपयोग करते समय advanced=true सेट करें।
min_depth वैकल्पिक
टाइप
int
विवरण
उन्नत — preset=functions|classes|methods|imports|variables को प्राथमिकता दें। न्यूनतम AST गहराई। path/ltree/call फ़िल्टर जानबूझकर उपयोग करते समय advanced=true सेट करें।
max_depth वैकल्पिक
टाइप
int
विवरण
उन्नत — preset=functions|classes|methods|imports|variables को प्राथमिकता दें। अधिकतम AST गहराई। path/ltree/call फ़िल्टर जानबूझकर उपयोग करते समय advanced=true सेट करें।

इसके लिए सबसे उपयुक्त:

  • AST-स्तर की संरचना: क्लास, डेकोरेटर, फ़ंक्शन/मेथड प्रीसेट
  • टेक्स्ट के बजाय आकार के आधार पर कोड खोजना

इसके लिए अनुशंसित नहीं:

  • मुक्त-पाठ या वैचारिक क्वेरी — semantic_search या intelligent_search का उपयोग करें

dependency_search स्टेबल

ब्लास्ट रेडियस और ग्राफ़ के लिए मुख्य टूल। वास्तविक कॉल/इम्पोर्ट ग्राफ़ से «इसे क्या कॉल करता है?» और «यह क्या इस्तेमाल करता है?» का जवाब देता है। बदलाव से पहले प्रभाव जानने के लिए: analysis_type="dependents" या analysis_type="impact" (आने वाली दिशा; impact की डिफ़ॉल्ट गहराई कम), और डिफ़ॉल्ट include_metrics=false (केंद्रीयता और refactor_risk के लिए चालू करें)। dependents/impact में डिफ़ॉल्ट रूप से production_callers शामिल हैं: प्रकार के अनुसार अद्वितीय प्रोडक्शन उपयोग स्थान (call, instantiate, मान के रूप में पास किए गए फ़ंक्शन के लिए value_reference), साथ में IMPORT स्थान; परीक्षण बाहर रखे जाते हैं और EXTRACTED/INFERRED विश्वास श्रेणी दी जाती है — केवल मेट्रिक का ढेर नहीं। PR/diff प्रभाव के लिए changed_paths और/या patch (एकीकृत diff) दें; यह हर पाथ के सिंबल पहचानकर कम गहराई वाले आने वाले निर्भर घटकों का संक्षिप्त डेटा लौटाता है, बिना सिंबल नाम माँगे। बदलाव के बाद targets और/या changed_paths के साथ verify_after_edit=true सेट करें, ताकि प्रभावित सिंबलों की कई मूल बिंदुओं से संक्षिप्त दोबारा क्वेरी हो सके। dependencies, centrality और orphans भी समर्थित हैं। analyze_dependencies कई चरणों वाली प्रभाव-जाँच के लिए यही ग्राफ़ भ्रमण इस्तेमाल करता है।

पैरामीटर:

repository वैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। पूरी तरह मेल खाने वाली इंडेक्स्ड ब्रांच को प्राथमिकता दी जाती है; अनुपलब्ध ब्रांच के मामले में main या एकमात्र सुलभ ब्रांच पर वापस जाया जा सकता है। प्रतिक्रिया के मेटाडेटा में अनुरोधित और वास्तव में उपयोग की गई पहचान दिखती है, और ऐसा होने पर चेतावनी दी जाती है।
query वैकल्पिक
टाइप
str
विवरण
सिंबल नाम या खोज शब्द
target वैकल्पिक
टाइप
str
विवरण
सिंबल नाम (query के लिए उपनाम)
symbol_id वैकल्पिक
टाइप
UUID
विवरण
नेमस्पेस, पथ और भाषा के अनुसार फ़िल्टर करने के बाद, query/target में दिए गए नाम के उम्मीदवारों में से UUID द्वारा किसी विशिष्ट उपस्थिति को चुनें। find_symbol या ग्राफ़ के वैकल्पिक परिणामों से लौटाए गए ID का उपयोग करें। केवल नाम निर्दिष्ट करके किए जाने वाले ट्रैवर्सल के लिए; सीमित उम्मीदवार दायरे से बाहर का ID त्रुटि उत्पन्न करता है।
changed_paths वैकल्पिक
टाइप
list[str] maxItems=50
विवरण
PR/diff प्रभाव (डिफ़ॉल्ट) के लिए सटीक रिपो-सापेक्ष फ़ाइल पाथ; verify_after_edit=true के साथ ये बदलाव के बाद जाँच के शुरुआती बिंदु बनते हैं। जिन पाथ का समाधान नहीं हो सका, वे लेबल किए गए सुझाव लौटा सकते हैं; सुझाई गई फ़ाइलें कभी भी प्रभाव के शुरुआती बिंदु नहीं बनतीं। PR/diff: लाइन की जानकारी न होने पर हर पाथ की टॉप-लेवल परिभाषाओं (पहले एक्सपोर्ट की गई, फ़ाइल के क्रम में) पर चलता है और changed_lines_unknown रिपोर्ट करता है; लाइन-स्तर पर बदले सिंबल के लिए patch= दें। सत्यापन: प्रति पाथ अधिकतम 5 टॉप-लेवल परिभाषाएँ जाँच के शुरुआती बिंदु बनती हैं (सत्यापन मोड के भीतर सीमा और कम है)। PR/diff प्रभाव के लिए query/target की आवश्यकता नहीं है।
patch वैकल्पिक
टाइप
str maxLength=500000
विवरण
PR/diff प्रभाव: unified diff / git patch टेक्स्ट। पाथ diff --git / --- / +++ हेडर से लिए जाते हैं; हंक की लाइनें (पुराना पक्ष = इंडेक्स किया गया कमिट) उन्हें घेरने वाले फ़ंक्शन/मेथड/क्लास से जोड़ी जाती हैं, और फिर उन पर चलकर सटीक डिपेंडेंट, public_api_changed और वे कॉलर मिलते हैं जिन्हें यह बदलाव नहीं छूता।
head_commit वैकल्पिक
टाइप
str pattern=^[0-9a-fA-F]{7,64}$
विवरण
जिस कोड के बारे में आप पूछ रहे हैं उसका कमिट SHA (git rev-parse HEAD, या पैच का बेस कमिट)। complete:true के लिए ज़रूरी है कि इंडेक्स इसी कमिट पर हो और मौजूदा रिज़ॉल्वर से बना हो; वरना यह index_stale / index_freshness_unverified / index_built_by_older_resolver के साथ complete:false ही रहता है, और index_basis.statement बताता है कि जवाब किस दायरे में पूरा है। पैच की 'base-commit:' लाइन (git format-patch --base) से भी यह मिल जाता है।
analysis_type वैकल्पिक
टाइप
Literal[centrality, dependencies, dependents, impact, orphans]
डिफ़ॉल्ट
dependencies
विवरण
विश्लेषण मोड। impact = ब्लास्ट रेडियस (incoming दिशा में निर्भर घटक; depth छोड़ने पर कम गहराई)। dependents भी प्रभाव बताता है। changed_paths या patch सेट होने पर PR/diff प्रभाव का विश्लेषण ही होता है। centrality/orphans के लिए लक्ष्य ज़रूरी नहीं है। orphans अप्रयुक्त कोड के उम्मीदवार हैं, यह प्रमाण नहीं कि उन्हें सुरक्षित रूप से हटाया जा सकता है; स्रोत में संदर्भ ज़रूर जाँचें।
depth वैकल्पिक
टाइप
Literal[shallow, balanced, deep]
विवरण
ट्रैवर्सल की गहराई। डिफ़ॉल्ट रूप से balanced; impact और PR/diff impact डिफ़ॉल्ट रूप से shallow का उपयोग करते हैं। स्पष्ट रूप से सेट किया गया depth इन डिफ़ॉल्ट को ओवरराइड करता है। वेरिफ़ाई मोड हमेशा shallow का उपयोग करता है।
limit वैकल्पिक
टाइप
int minimum=1, maximum=50
डिफ़ॉल्ट
20
विवरण
cursor का उपयोग न करने पर प्रति पेज अधिकतम परिणाम। जारी रखने पर cursor में संग्रहीत पेज साइज़ का उपयोग होता है; अलग limit से शुरू करने के लिए cursor छोड़ें।
offset वैकल्पिक
टाइप
int minimum=0
विवरण
पुरानी संगतता के लिए रखा गया, अब अनुशंसित नहीं: offset। pagination.next_cursor से मिले cursor को प्राथमिकता दें।
cursor वैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से मिला ओपेक cursor। इसे बिना बदले पास करें और query तथा फ़िल्टर को अपरिवर्तित रखें। इसकी स्थिति और पेज साइज़ को offset और limit पर प्राथमिकता मिलती है।
path_filter वैकल्पिक
टाइप
str
विवरण
फ़ाइल पथ प्रीफ़िक्स द्वारा लक्ष्य सिंबल रिज़ॉल्यूशन सीमित करें; लौटाए गए ग्राफ़ संबंध उस पथ के बाहर तक जा सकते हैं
language_filter वैकल्पिक
टाइप
str
विवरण
लक्ष्य रिज़ॉल्यूशन और ब्राउज़ परिणामों को भाषा से फ़िल्टर करें
direction वैकल्पिक
टाइप
Literal[outgoing, incoming, both]
विवरण
ट्रैवर्सल दिशा (analysis_type के अनुमान को ओवरराइड करता है)
relationship_types वैकल्पिक
टाइप
list[str]
विवरण
एज प्रकारों को फ़िल्टर करें (CALL, IMPORT, INHERITS_FROM, आदि)। एक गैर-रिक्त सूची graph_view डिफ़ॉल्ट को ओवरराइड करती है।
exclude_test_paths वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
true
विवरण
डिफ़ॉल्ट true: ट्रैवर्सल और centrality परिणामों से test, fixture, vendor, और उदाहरण पथ हटाएँ। इन्हें शामिल करने के लिए false सेट करें। Orphan विश्लेषण इसका पालन केवल वहीं करता है जहाँ तैनात बैकएंड इसका समर्थन करता है; अन्यथा यह अपने स्वयं के अधिक सख्त शोर-बहिष्करण बनाए रखता है और इस समायोजन की रिपोर्ट करता है।
exclude_generated_paths वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
ट्रैवर्सल परिणामों से जेनरेट की गई घोषणाओं के साथ-साथ बिल्ड, कवरेज, कैश, सोर्स-मैप और मिनिफाइड आर्टिफैक्ट पथों को बाहर निकालें
include_module_symbols वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
डिफ़ॉल्ट रूप से, false ग्राफ़ किनारों को बाहर कर देता है जब from_name या to_name सिंथेटिक __module__ सिंबल (मॉड्यूल-स्तरीय शोर) होता है। आश्रित और निर्भरता संबंधों के परिणामों में मॉड्यूल-स्तरीय किनारों को शामिल करने के लिए true सेट करें।
include_isolated वैकल्पिक
टाइप
bool
विवरण
केवल orphans के लिए। डिफ़ॉल्ट false। ऐसे सिंबल भी लौटाने के लिए true सेट करें जिनकी ग्राफ़-मेट्रिक्स में कोई पंक्ति नहीं है (कहीं भी कोई ग्राफ़ किनारा नहीं)। जब तक exclude_test_paths true है, स्टाइलशीट/मार्कअप/डेटा सिंबल (CSS, HTML, ...), .d.ts घोषणाएँ और test/fixture/vendor/example पथ वहाँ बाहर रहते हैं जहाँ बैकएंड इसका समर्थन करता है, जब तक language_filter उस भाषा का नाम न दे; TypeScript ऑब्जेक्ट-लिटरल गुण फिर भी पृथक फ़ंक्शन के रूप में दिख सकते हैं।
exclude_exported वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
केवल अनाथ सिंबलों के लिए। डिफ़ॉल्ट false: रिपॉज़िटरी में कहीं उपयोग न होने वाले निर्यातित सिंबल (सार्वजनिक API) भी is_exported=true के साथ लौटते हैं। केवल आंतरिक उम्मीदवारों के लिए true सेट करें।
branch वैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
per_hop_limit वैकल्पिक
टाइप
int minimum=1, maximum=300
विवरण
प्रति हॉप अधिकतम संबंध (1-300)
include_metrics वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
परिणाम पंक्तियों पर वैकल्पिक ग्राफ़ मेट्रिक्स (refactor_risk के साथ संक्षिप्त)। min_centrality>0 होने पर मेट्रिक्स आंतरिक रूप से भी प्राप्त किए जाते हैं लेकिन इसके true न होने तक नहीं लौटाए जाते।
metrics_detail वैकल्पिक
टाइप
Literal[summary, full]
डिफ़ॉल्ट
summary
विवरण
जब include_metrics=true: summary (डिफ़ॉल्ट) निर्णय संकेत लौटाता है + refactor_risk; full बड़ा क्यूरेटेड मीट्रिक सेट लौटाता है
include_edge_metadata वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
कच्चे किनारे का मेटाडेटा और वज़न (बड़ा) शामिल करें। कॉम्पैक्ट इम्पैक्ट पेलोड इसे बंद कर देते हैं।
symbol_types वैकल्पिक
टाइप
list[str]
विवरण
लौटाए गए सिंबल को प्रकार (function, class, method आदि) के अनुसार फ़िल्टर करता है। orphan विश्लेषण में समर्थित नहीं है; वहां इसके बजाय path_filter या language_filter का उपयोग करें। खाली सूची कोई प्रकार फ़िल्टर लागू नहीं करती।
exact_match वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
सिंबल नाम का सटीक मिलान आवश्यक करें
find_similar_patterns वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
समान उपयोग पैटर्न खोजें
min_centrality वैकल्पिक
टाइप
float minimum=0
डिफ़ॉल्ट
0
विवरण
नामित सिंबल भ्रमण और PR/diff प्रभाव विश्लेषण के लिए न्यूनतम PageRank स्कोर। centrality/orphans ब्राउज़ मोड में शून्य से बड़ी सीमाएँ समर्थित नहीं हैं। फ़िल्टरिंग के लिए मेट्रिक्स आंतरिक रूप से प्राप्त किए जाते हैं; graph_metrics केवल तभी लौटाए जाते हैं जब include_metrics=true हो। verify_after_edit इसे अनदेखा करता है, क्योंकि वह निश्चित संक्षिप्त नियंत्रणों का उपयोग करता है।
graph_view वैकल्पिक
टाइप
Literal[dependency, type, data_flow, control_flow]
डिफ़ॉल्ट
dependency
विवरण
ट्रैवर्सल संबंध डिफ़ॉल्ट, मेट्रिक्स, और centrality रैंकिंग के लिए उपयोग किया गया graph view; orphan विश्लेषण सभी दृश्यों में गणना किया जाता है
verify_after_edit वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
संपादित सिंबल के लिए इंडेक्स किए गए impact ग्राफ़ को एक संक्षिप्त मल्टी-रूट प्रतिक्रिया में फिर से क्वेरी करता है। targets और/या changed_paths (या target/query) आवश्यक है। यह एक निश्चित shallow ट्रैवर्सल और संक्षिप्त बजट का उपयोग करता है; depth/limit/cursor/metrics नियंत्रण लागू नहीं होते। डिफ़ॉल्ट रूप से incoming dependents लौटाता है; परिणाम इंडेक्स किए गए ग्राफ़ को दर्शाते हैं (लाइव संपादनों से पीछे हो सकते हैं)। true होने पर, यह समान changed_paths के लिए PR/diff impact पर प्राथमिकता लेता है।
targets वैकल्पिक
टाइप
list[str] maxItems=15
विवरण
जब verify_after_edit=true: सिंबल नाम पुनः सत्यापित करने के लिए (कॉल करने वाले/आश्रित)। यदि दोनों की आपूर्ति की जाती है तो target/query के साथ विलय कर दिया जाएगा।

इसके लिए सबसे उपयुक्त:

  • किसी साझा सिंबल को संपादित करने से पहले ब्लास्ट रेडियस / इम्पैक्ट विश्लेषण
  • changed_paths या patch के माध्यम से PR/diff प्रभाव
  • verify_after_edit के माध्यम से संपादन-पश्चात सत्यापन

इसके लिए अनुशंसित नहीं:

  • सरल टेक्स्ट या सिंबल लुकअप — text_pattern_search या find_symbol का उपयोग करें

कोड विश्लेषण टूल

#

find_symbol स्टेबल

किसी फ़ंक्शन, क्लास, या वेरिएबल की परिभाषा और उपयोग पर सीधे जाएं। जब नाम ज्ञात हो (उदा. "getCurrentUser") तो यह Grep से तेज़ और सटीक है और पूरे इंडेक्स्ड रिपॉज़िटरी को कवर करता है। वैकल्पिक रूप से रेफ़रेंस और महत्व मेट्रिक्स लौटाता है।

पैरामीटर:

symbol_name वैकल्पिक
टाइप
str
विवरण
खोजने के लिए सिंबल नाम (वैकल्पिक — मीट्रिक्स देखकर ब्राउज़ करने हेतु छोड़ें)
repository वैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। पूरी तरह मेल खाने वाली इंडेक्स्ड ब्रांच को प्राथमिकता दी जाती है; अनुपलब्ध ब्रांच के मामले में main या एकमात्र सुलभ ब्रांच पर वापस जाया जा सकता है। प्रतिक्रिया के मेटाडेटा में अनुरोधित और वास्तव में उपयोग की गई पहचान दिखती है, और ऐसा होने पर चेतावनी दी जाती है।
scope वैकल्पिक
टाइप
Literal[definitions, references, both]
डिफ़ॉल्ट
both
विवरण
खोज का दायरा; references के लिए एक गैर-रिक्त symbol_name आवश्यक है।
limit वैकल्पिक
टाइप
int minimum=1, maximum=50
डिफ़ॉल्ट
15
विवरण
cursor का उपयोग न करने पर प्रति पेज अधिकतम परिणाम। जारी रखने पर cursor में संग्रहीत पेज साइज़ का उपयोग होता है; अलग limit से शुरू करने के लिए cursor छोड़ें।
offset वैकल्पिक
टाइप
int minimum=0
विवरण
पुरानी संगतता के लिए रखा गया, अब अनुशंसित नहीं: offset। pagination.next_cursor से मिले cursor को प्राथमिकता दें।
cursor वैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से मिला ओपेक cursor। इसे बिना बदले पास करें और query तथा फ़िल्टर को अपरिवर्तित रखें। इसकी स्थिति और पेज साइज़ को offset और limit पर प्राथमिकता मिलती है।
find_similar वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
समान सिंबल नाम भी शामिल करें
include_metrics वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
सेंट्रालिटी मेट्रिक्स शामिल करें
metrics_detail वैकल्पिक
टाइप
Literal[summary, full]
डिफ़ॉल्ट
summary
विवरण
जब include_metrics=true: summary (डिफ़ॉल्ट) निर्णय संकेत लौटाता है + refactor_risk; full बड़ा क्यूरेटेड मीट्रिक सेट लौटाता है
path_filter वैकल्पिक
टाइप
str
विवरण
फ़ाइल पाथ प्रीफ़िक्स से फ़िल्टर करें
branch वैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
symbol_type वैकल्पिक
टाइप
str minLength=1
विवरण
इंडेक्स किए गए सिंबल प्रकार के अनुसार फ़िल्टर करें, जैसे function, class, struct, enum, या trait। सिंबल परिणाम द्वारा लौटाए गए प्रकार का उपयोग करें; प्रकार भाषा के अनुसार भिन्न होता है।
high_impact वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
आर्किटेक्चरल रूप से महत्वपूर्ण सिंबल ब्राउज़ करें (symbol_name छोड़ें)। डिफ़ॉल्ट मोड लोकप्रियता है (शीर्ष PageRank दशमक माइनस उपयोगिता मेगा-हब)। संधि/सेतु कट-वर्टिसेस के लिए high_impact_mode=risk सेट करें।
high_impact_mode वैकल्पिक
टाइप
Literal[popularity, risk]
डिफ़ॉल्ट
popularity
विवरण
high_impact=true होने पर: popularity = शीर्ष PageRank डेसाइल, यूटिलिटी मेगा-हब/मॉड्यूल को छोड़कर; risk = आर्टिक्यूलेशन पॉइंट, जिन्हें पहले SMV bridge_count और फिर k_core से रैंक किया जाता है (संरचनात्मक रीफ़ैक्टर जोखिम, हब की लोकप्रियता नहीं)
in_cycle वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
उन सिंबल को फ़िल्टर करता है जिनकी डिपेंडेंसी-साइकिल सदस्यता दर्ज है।
exclude_test_paths वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
true
विवरण
ग्राफ़ मेट्रिक्स द्वारा ब्राउज़ करते समय, रैंकिंग से पहले परीक्षण, fixtures, तृतीय-पक्ष कोड और उदाहरणों को बाहर कर दें। नामित सिंबल द्वारा लुकअप अपरिवर्तित है.
reference_views वैकल्पिक
टाइप
list[Literal[dependency, type, data_flow, control_flow, all]] minItems=1, maxItems=5
विवरण
वे ग्राफ़ व्यू जिनके आने वाले किनारे references/reference_count भरते हैं (scope references/both)। डिफ़ॉल्ट ["dependency", "type"] में कॉल, आयात, निर्यात, संदर्भ, इंस्टैंस बनाना, विरासत, ओवरराइड, डेकोरेटर और टाइप का उपयोग शामिल हैं। data_flow न चुने जाने पर सटीक रूप से हल किए गए data_flow उपयोग (कॉलबैक, हैंडलर, सॉर्ट कुंजियाँ) अलग से value_references/value_reference_count में लौटते हैं; केवल नाम से अनुमानित मिलान शामिल नहीं होते। data_flow या control_flow जोड़ें, या सभी किनारा प्रकारों और स्तरों के लिए ["all"] दें। व्यू परिवार dependency_search के graph_view जैसे ही हैं।
relationship_types वैकल्पिक
टाइप
list[str]
विवरण
स्पष्ट संदर्भ किनारा प्रकार (CALL, IMPORT, READS आदि)। गैर-खाली सूची reference_views को बदल देती है।

इसके लिए सबसे उपयुक्त:

  • किसी ज्ञात सिंबल की परिभाषा, संदर्भ और ग्राफ़ मेट्रिक्स को पिन करना
  • जब symbol_name छोड़ा गया हो तब centrality, high_impact या in_cycle के आधार पर ब्राउज़ करना

इसके लिए अनुशंसित नहीं:

  • वैचारिक या अज्ञात-क्षेत्र क्वेरी — intelligent_search या semantic_search का उपयोग करें

analyze_dependencies स्टेबल

dependency_search (dependents/incoming) जैसा ही ग्राफ़ भ्रमण करके ब्लास्ट रेडियस जाँचें। प्रभाव-जाँच के लिए analysis_type="dependents" या "impact" के साथ dependency_search को प्राथमिकता दें। यह graph, connection_summary और refactor_risk सहित वैकल्पिक मेट्रिक्स के साथ कई चरणों वाला प्रभाव रिस्पॉन्स लौटाता है। connection_summary, चुने गए रूट के लिए संबंध-समूह तक सीमित एजों की गिनती करता है, और यह गिनती टेस्ट/पाथ फ़िल्टरिंग से पहले होती है। पुराने incoming_production/outgoing_production फ़ील्ड मॉड्यूल-रहित एजों को दर्शाते हैं, जिनमें टेस्ट भी शामिल हैं; ये प्रोडक्शन कॉल करने वालों की गिनती नहीं हैं। संबंधों का समूह सीमित करने के लिए graph_view इस्तेमाल करें: dependency (डिफ़ॉल्ट), type, data_flow, control_flow।

पैरामीटर:

repository वैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। पूरी तरह मेल खाने वाली इंडेक्स्ड ब्रांच को प्राथमिकता दी जाती है; अनुपलब्ध ब्रांच के मामले में main या एकमात्र सुलभ ब्रांच पर वापस जाया जा सकता है। प्रतिक्रिया के मेटाडेटा में अनुरोधित और वास्तव में उपयोग की गई पहचान दिखती है, और ऐसा होने पर चेतावनी दी जाती है।
target आवश्यक
टाइप
str minLength=1
विवरण
विश्लेषण हेतु सिंबल नाम
symbol_id वैकल्पिक
टाइप
UUID
विवरण
नेमस्पेस, पथ और भाषा के अनुसार फ़िल्टर करने के बाद, target उम्मीदवारों में से UUID द्वारा किसी विशिष्ट उपस्थिति को चुनें; सीमित उम्मीदवार दायरे से बाहर के ID त्रुटि उत्पन्न करते हैं।
depth वैकल्पिक
टाइप
Literal[shallow, balanced, deep]
डिफ़ॉल्ट
balanced
विवरण
विश्लेषण गहराई
limit वैकल्पिक
टाइप
int minimum=1, maximum=50
डिफ़ॉल्ट
10
विवरण
cursor का उपयोग न करने पर प्रति पेज अधिकतम परिणाम। जारी रखने पर cursor में संग्रहीत पेज साइज़ का उपयोग होता है; अलग limit से शुरू करने के लिए cursor छोड़ें।
offset वैकल्पिक
टाइप
int minimum=0
विवरण
पुरानी संगतता के लिए रखा गया, अब अनुशंसित नहीं: offset। pagination.next_cursor से मिले cursor को प्राथमिकता दें।
cursor वैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से मिला ओपेक cursor। इसे बिना बदले पास करें और query तथा फ़िल्टर को अपरिवर्तित रखें। इसकी स्थिति और पेज साइज़ को offset और limit पर प्राथमिकता मिलती है।
direction वैकल्पिक
टाइप
Literal[incoming, outgoing, both]
डिफ़ॉल्ट
incoming
विवरण
ट्रैवर्सल की दिशा
relationship_types वैकल्पिक
टाइप
list[str]
विवरण
एज प्रकार (CALL, IMPORT, INHERITS_FROM आदि) के अनुसार फ़िल्टर करता है। गैर-रिक्त सूची graph_view के डिफ़ॉल्ट को ओवरराइड करती है; खाली सूची उन डिफ़ॉल्ट का उपयोग करती है।
graph_view वैकल्पिक
टाइप
Literal[dependency, type, data_flow, control_flow]
डिफ़ॉल्ट
dependency
विवरण
ग्राफ़ व्यू: यह डिफ़ॉल्ट रूप से ट्रैवर्स किए जाने वाले एज प्रकार और include_metrics=true होने पर किस व्यू के मेट्रिक्स का उपयोग किया जाता है, दोनों तय करता है। dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (डिफ़ॉल्ट), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]। relationship_types छोड़े जाने या खाली होने पर इसे relationship_types के डिफ़ॉल्ट के रूप में लागू किया जाता है। उपकरणों के बीच स्थिरता के लिए dependency_search के मौजूदा graph_view पैरामीटर नाम से मेल खाता है।
path_filter वैकल्पिक
टाइप
str
विवरण
फ़ाइल पथ प्रीफ़िक्स द्वारा लक्ष्य सिंबल रिज़ॉल्यूशन सीमित करें; लौटाए गए ग्राफ़ संबंध उस पथ के बाहर तक जा सकते हैं
language_filter वैकल्पिक
टाइप
str
विवरण
परिणामों को किसी भाषा तक सीमित करें
branch वैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
per_hop_limit वैकल्पिक
टाइप
int minimum=1, maximum=300
विवरण
प्रति हॉप अधिकतम संबंध (1-300)
include_metrics वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
परिणामों में ग्राफ़ मेट्रिक्स शामिल करें, प्रत्येक व्युत्पन्न refactor_risk ब्लॉक ({risk: "low"|"medium"|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}) से समृद्ध हो। risk तब "low" होता है जब एक आर्टिक्यूलेशन बिंदु नहीं होता है (चयनित दृश्य में), "medium" होता है जब एक आर्टिक्यूलेशन बिंदु कुछ किनारों को पाटता है, "high" होता है जब कई किनारों को पाटता है (अनुमानित सीमा, अनुभवजन्य रूप से मान्य नहीं)। जब उस सिंबल/दृश्य के लिए कोई मीट्रिक पंक्ति मौजूद नहीं होती तो प्रति-सिंबल हटा दिया जाता है।
metrics_detail वैकल्पिक
टाइप
Literal[summary, full]
डिफ़ॉल्ट
summary
विवरण
जब include_metrics=true: summary (डिफ़ॉल्ट) निर्णय संकेत लौटाता है + refactor_risk; full बड़ा क्यूरेटेड मीट्रिक सेट लौटाता है
include_edge_metadata वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
कच्चे किनारे का मेटाडेटा और वज़न शामिल करें। डिफ़ॉल्ट रूप से अक्षम क्योंकि एक्सट्रैक्टर मेटाडेटा बड़ा हो सकता है; सक्षम होने पर संवर्धन कवरेज की सूचना दी जाती है।
exclude_test_paths वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
true
विवरण
डिफ़ॉल्ट true: लौटाए गए ग्राफ़ एज से टेस्ट, फ़िक्स्चर, थर्ड-पार्टी कोड और उदाहरणों के पाथ बाहर रखता है। इन्हें शामिल करने के लिए false सेट करें।
include_module_symbols वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
डिफ़ॉल्ट रूप से, false ग्राफ़ किनारों को बाहर कर देता है जब from_name या to_name सिंथेटिक __module__ सिंबल होता है। मॉड्यूल-स्तरीय किनारों को शामिल करने के लिए true सेट करें।
head_commit वैकल्पिक
टाइप
str pattern=^[0-9a-fA-F]{7,64}$
विवरण
जिस कोड के बारे में आप पूछ रहे हैं उसका कमिट SHA (git rev-parse HEAD, या पैच का बेस कमिट)। complete:true के लिए ज़रूरी है कि इंडेक्स इसी कमिट पर हो और मौजूदा रिज़ॉल्वर से बना हो; वरना यह index_stale / index_freshness_unverified / index_built_by_older_resolver के साथ complete:false ही रहता है, और index_basis.statement बताता है कि जवाब किस दायरे में पूरा है। पैच की 'base-commit:' लाइन (git format-patch --base) से भी यह मिल जाता है।

इसके लिए सबसे उपयुक्त:

  • कई चरणों वाली प्रभाव-जाँच, जब रिस्पॉन्स में graph और connection_summary फ़ील्ड चाहिए

इसके लिए अनुशंसित नहीं:

  • सामान्य प्रभाव-जाँच: लचीले ग्राफ़ भ्रमण और कई मूल बिंदुओं से जाँच के लिए dependency_search को प्राथमिकता दें

get_task_context स्टेबल

किसी अपरिचित क्षेत्र में काम शुरू कर रहे हैं? टास्क का विवरण दें (जैसे "SSO सपोर्ट जोड़ें", "बिलिंग वेबहुक ठीक करें") और एक ही कॉल में संबंधित फ़ाइलों, कोड, सिंबल और डिपेंडेंसी का एक सीमित बंडल प्राप्त करें। शुरुआती बिंदु के रूप में दी गई फ़ाइलें, सिंबल परिभाषित न करने पर भी सीधे इंडेक्स की गई सामग्री देती हैं। असफल लेयर को लेबल किया जाता है; पूर्ण रिट्रीवल विफलता पर एक टूल एरर लौटाया जाता है। अधिक परिणामों के लिए, उस लेयर के लिए विशेष सर्च टूल के साथ आगे बढ़ें।

पैरामीटर:

task_description आवश्यक
टाइप
str minLength=1
विवरण
जिस टास्क के लिए आप संदर्भ चाहते हैं उसका विवरण
repository वैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। पूरी तरह मेल खाने वाली इंडेक्स्ड ब्रांच को प्राथमिकता दी जाती है; अनुपलब्ध ब्रांच के मामले में main या एकमात्र सुलभ ब्रांच पर वापस जाया जा सकता है। प्रतिक्रिया के मेटाडेटा में अनुरोधित और वास्तव में उपयोग की गई पहचान दिखती है, और ऐसा होने पर चेतावनी दी जाती है।
limit वैकल्पिक
टाइप
int minimum=1, maximum=50
डिफ़ॉल्ट
15
विवरण
प्रति लेयर अधिकतम संदर्भ आइटम
scope वैकल्पिक
टाइप
Literal[semantic, symbols, dependencies, all]
डिफ़ॉल्ट
all
विवरण
कौन-सी कॉन्टेक्स्ट लेयर शामिल करनी हैं
language_filter वैकल्पिक
टाइप
str
विवरण
भाषा फ़िल्टर: स्पष्ट शुरुआती बीज या संबंधित संदर्भ के बिना scope=semantic चाहिए; अन्य परतों के इंडेक्स भाषा लागू नहीं कर सकते।
path_filter वैकल्पिक
टाइप
str
विवरण
सिमेंटिक और कीवर्ड रिट्रीवल के मूल बिंदुओं के लिए फ़ाइल पाथ प्रीफ़िक्स। स्पष्ट सीड इस प्रीफ़िक्स के बाहर भी हो सकते हैं; ग्राफ़ संदर्भ डायरेक्टरी की सीमाओं को पार कर सकता है।
branch वैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
include_related_context वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
आसन्न सिंबलों से संबंधित संदर्भ शामिल करें
seed_symbol_ids वैकल्पिक
टाइप
list[str] maxItems=20
विवरण
स्पष्ट टास्क सीड: सिंबल लेयर में सबसे पहले आते हैं और सीमित dependencies/related_context विंडो के भीतर बनाए रखे जाते हैं। ग्राफ़ लेयर कीवर्ड पर लौटने से पहले स्पष्ट सीड और उनके निकटतम पड़ोस को रैंक करती हैं; प्रासंगिकता बराबर होने पर ही महत्व से क्रम तय होता है। ग्राफ़ विस्तार के लिए scope=all|dependencies आवश्यक है (scope=symbols|semantic कभी भी निर्भरता ट्रैवर्सल नहीं चलाता)। केवल-कीवर्ड और गहराई के अनुसार घटते महत्व वाली रैंकिंग के लिए इसे छोड़ दें।
seed_file_paths वैकल्पिक
टाइप
list[str] maxItems=10
विवरण
स्पष्ट सीड्स: वे सटीक इंडेक्स की गई फ़ाइल पथ जो एजेंट ने खोली हैं या अभी संपादित की हैं। सीमित प्रत्यक्ष फ़ाइल साक्ष्य और प्रति फ़ाइल 5 तक ग्राफ़ सीड लौटाता है, जिसमें सीमित सिंबल लुकअप से मिले टास्क-नाम के सटीक मिलान को परिभाषाओं और प्रासंगिक रूप से आए सिंबल से पहले रखा जाता है। सिंबल-रहित फ़ाइलें भी साक्ष्य देती हैं। गुम फ़ाइलें लेबल किए गए सुझाव लौटा सकती हैं जो सीड नहीं होते। ग्राफ़ विस्तार के लिए scope=all|dependencies आवश्यक है।

इसके लिए सबसे उपयुक्त:

  • कार्य-सजग संदर्भ जो सीड की गई फ़ाइलों को सिमैंटिक, सिंबल और डिपेंडेंसी लेयर के साथ मिलाता है

इसके लिए अनुशंसित नहीं:

  • एकल-टूल लुकअप जहाँ कोई अधिक विशिष्ट टूल पहले ही प्रश्न का उत्तर दे देता है

get_file स्टेबल

पथ के अनुसार इंडेक्स किए गए रिपॉज़िटरी से एक फ़ाइल पढ़ता है। डिस्क पर मौजूद फ़ाइलों के लिए स्थानीय फ़ाइल टूल को प्राथमिकता दें; इसका उपयोग रिमोट इंडेक्स किए गए स्नैपशॉट के लिए करें। metadata.next_line_start और next_character_start के साथ सीमित प्रतिक्रियाएँ जारी रखें। अंतिम न्यूलाइन और [truncated] मार्कर को केवल तभी हटाएँ जब metadata.truncated=true हो; अन्यथा यह शाब्दिक स्रोत टेक्स्ट हो सकता है।

पैरामीटर:

file_path आवश्यक
टाइप
str
विवरण
रिपॉज़िटरी रूट के सापेक्ष फ़ाइल पथ
repository वैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। पूरी तरह मेल खाने वाली इंडेक्स्ड ब्रांच को प्राथमिकता दी जाती है; अनुपलब्ध ब्रांच के मामले में main या एकमात्र सुलभ ब्रांच पर वापस जाया जा सकता है। प्रतिक्रिया के मेटाडेटा में अनुरोधित और वास्तव में उपयोग की गई पहचान दिखती है, और ऐसा होने पर चेतावनी दी जाती है।
line_start वैकल्पिक
टाइप
int minimum=1
विवरण
आरम्भिक लाइन (1-इंडेक्स्ड)
line_end वैकल्पिक
टाइप
int minimum=1
विवरण
अंतिम लाइन (1-इंडेक्स्ड, समावेशी; line_start पर या उसके बाद होनी चाहिए)
character_start वैकल्पिक
टाइप
int minimum=0
डिफ़ॉल्ट
0
विवरण
केवल शुरुआती लाइन के भीतर UTF-16 कोड इकाइयों में ऑफ़सेट (सूचकांक 0 से शुरू)। आंशिक रूप से पढ़ी गई लाइन को आगे पढ़ने के लिए metadata.next_character_start का उपयोग करें।
branch वैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
max_tokens वैकल्पिक
टाइप
int minimum=1, maximum=50000
डिफ़ॉल्ट
5000
विवरण
सामग्री का अनुमानित बजट (प्रति टोकन 4 UTF-16 कोड यूनिट; टोकनाइज़र की सटीक सीमा नहीं)।
include_metadata वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
true
विवरण
फ़ाइल का वर्णन करने वाला मेटाडेटा शामिल करें। कटौती और आगे पढ़ने का मेटाडेटा हमेशा लौटाया जाता है।

इसके लिए सबसे उपयुक्त:

  • रिमोट या इंडेक्स की गई फ़ाइल स्नैपशॉट (लाइन रेंज, टोकन सीमाएँ)

इसके लिए अनुशंसित नहीं:

  • पाथ जो पहले से लोकल डिस्क पर है — लोकल Read टूल का उपयोग करें

सिस्टम और यूटिलिटी टूल

#

repository_context स्टेबल

उन रिपॉज़िटरी की सूची देता है जिन्हें आप खोज सकते हैं, या किसी एक की पहचान संबंधी जानकारी (namespace/branch, indexed_commit_sha / इंडेक्स की ताज़गी) प्राप्त करता है। जब रिपॉज़िटरी slug ज्ञात न हो तो action:"list" का उपयोग करें; सर्च टूल किसी ज्ञात slug को सीधे स्वीकार करते हैं या डिफ़ॉल्ट रूप से आपकी कुंजी की एकमात्र रिपॉज़िटरी का उपयोग करते हैं। list, pattern और पेजिनेशन का उपयोग करता है; info के लिए repository आवश्यक है और यह branch तथा वैकल्पिक include_statistics=true का समर्थन करता है।

पैरामीटर:

action आवश्यक
टाइप
Literal[list, info]
विवरण
कार्य: उपलब्ध रिपॉज़िटरी सूची बनाएं या किसी रिपॉज़िटरी की जानकारी लें (मान: 'list' या 'info')
repository वैकल्पिक
टाइप
str
विवरण
केवल info के लिए: owner/repo या owner/repo:branch प्रारूप में रिपॉज़िटरी (info के लिए आवश्यक)
branch वैकल्पिक
टाइप
str
विवरण
केवल info के लिए: ब्रांच ओवरराइड
pattern वैकल्पिक
टाइप
str
विवरण
केवल list के लिए: रिपॉज़िटरी नाम का सबस्ट्रिंग, जो केस-संवेदी नहीं है
include_statistics वैकल्पिक
टाइप
bool
डिफ़ॉल्ट
false
विवरण
केवल जानकारी के लिए: सीमित इंडेक्स्ड-डेटा गणनाएँ शामिल करता है। file/blob गणनाएँ सटीक होती हैं; बड़ी इंडेक्स गणनाएँ अनुमानित होती हैं। count_accuracy और estimate_analyzed_at पढ़ें। डिफ़ॉल्ट false है।
limit वैकल्पिक
टाइप
int minimum=1, maximum=50
डिफ़ॉल्ट
20
विवरण
cursor का उपयोग न करने पर प्रति पेज अधिकतम परिणाम। जारी रखने पर cursor में संग्रहीत पेज साइज़ का उपयोग होता है; अलग limit से शुरू करने के लिए cursor छोड़ें।
offset वैकल्पिक
टाइप
int minimum=0
विवरण
पुरानी संगतता के लिए रखा गया, अब अनुशंसित नहीं: offset। pagination.next_cursor से मिले cursor को प्राथमिकता दें।
cursor वैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से मिला ओपेक cursor। इसे बिना बदले पास करें और query तथा फ़िल्टर को अपरिवर्तित रखें। इसकी स्थिति और पेज साइज़ को offset और limit पर प्राथमिकता मिलती है।

इसके लिए सबसे उपयुक्त:

  • सुलभ रिपॉज़िटरी की सूची बनाना
  • रिपॉज़िटरी की पहचान, ब्रांच और HEAD-vs-इंडेक्स ताज़गी का समाधान करना

इसके लिए अनुशंसित नहीं:

  • डिफ़ॉल्ट रूप से नेमस्पेस-व्यापी आँकड़े — include_statistics=true को स्पष्ट रूप से पास करें, क्योंकि यह समाधान की तुलना में धीमा हो सकता है

ask_maguyva स्टेबल

Maguyva टूल्स का मार्गदर्शन लें या बग रिपोर्ट/फ़ीचर अनुरोध भेजें, जो Maguyva का रखरखाव करने वालों के लिए सहेजा जाता है। प्रतिक्रिया में कभी भी गोपनीय जानकारी या संवेदनशील व्यक्तिगत डेटा न दें। evaluate ऑपरेशन निश्चित परिणाम देने वाले एक्सप्रेशन सपोर्ट करता है; गणित, हैश और स्ट्रिंग के कामों के लिए स्थानीय गणना या होस्ट परिवेश के टूल्स को प्राथमिकता दें।

पैरामीटर:

operation आवश्यक
टाइप
Literal[guidance, report_bug, request_feature, evaluate]
विवरण
टूल सहायता के लिए guidance, बग के लिए report_bug और सुझावों के लिए request_feature इस्तेमाल करें। evaluate निश्चित परिणाम देने वाले एक्सप्रेशन चलाता है; गणना के लिए स्थानीय साधनों को प्राथमिकता दें।
query वैकल्पिक
टाइप
str maxLength=500
विवरण
मार्गदर्शन का विषय (जैसे tool_selection, semantic_search) या evaluate के लिए एक्सप्रेशन स्ट्रिंग।
description वैकल्पिक
टाइप
str minLength=1, maxLength=4000
विवरण
report_bug और request_feature के लिए आवश्यक। Maguyva के मेंटेनर्स के लिए मुक्त-रूप फ़ीडबैक। इसमें कभी भी गोपनीय जानकारी या संवेदनशील व्यक्तिगत डेटा न दें।
related_tool वैकल्पिक
टाइप
Literal[ask_maguyva, get_file, repository_context, find_symbol, structural_search, dependency_search, analyze_dependencies, semantic_search, text_pattern_search, intelligent_search, get_task_context]
विवरण
फ़ीडबैक से सबसे अधिक संबंधित Maguyva टूल; वैकल्पिक

इसके लिए सबसे उपयुक्त:

  • टूल मार्गदर्शन (operation="guidance")
  • Maguyva के मेंटेनर्स के लिए टिकाऊ बग रिपोर्ट और फ़ीचर अनुरोध

इसके लिए अनुशंसित नहीं:

  • गणित, हैश और स्ट्रिंग की गणना: स्थानीय गणना या होस्ट परिवेश के टूल्स को प्राथमिकता दें

सर्वोत्तम अभ्यास

#
  1. स्पष्ट ओवरराइड का सोच-समझकर उपयोग करें: जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो रिपॉज़िटरी छोड़ दें; अन्यथा इसे स्पष्ट रूप से पास करें।
  2. सही सर्च मोड चुनें: अधिकतर मामलों में intelligent_search को mode="auto" के साथ प्रयोग करें। जब आपको ठीक-ठीक पता हो कि क्या चाहिए, तो मोड निर्दिष्ट करें।
  3. भाषा फ़िल्टर का लाभ उठाएँ: language_filter से परिणाम सीमित करें और प्रदर्शन सुधारें।
  4. GraphRAG बूस्टिंग: सिमेंटिक सर्च के लिए GraphRAG महत्त्व बूस्टिंग डिफ़ॉल्ट रूप से बंद है (boost_by_importance=false) ताकि रैंकिंग एजेंट-सुरक्षित रहे। आर्किटेक्चर टूर के लिए सेंट्रैलिटी-अवेयर री-रैंकिंग सक्षम करने हेतु boost_by_importance=true पास करें।
  5. रिपॉज़िटरी मिलान केस-असंवेदनशील है, फ़ज़ी नहीं: repository_context रिपॉज़िटरी नामों का मिलान केस को नज़रअंदाज़ करते हुए करता है — यह टाइपिंग की गलतियाँ ठीक नहीं करता। जब दी गई पहचान अनुरोध की गई पहचान से अलग होती है, तो metadata.resolution_reason में "defaulted" (कोई ब्रांच नहीं मांगी गई) या "fallback" (मांगी गई ब्रांच या रिपॉज़िटरी उपलब्ध नहीं) दर्ज होता है। अनुरोध के ठीक-ठीक मिलने पर यह फ़ील्ड छोड़ दिया जाता है।
  6. टूल्स को मिलाएँ: व्यापक विश्लेषण के लिए एक साथ कई API मेथड उपयोग करें।
  7. बड़े रिज़ल्ट संभालें: limit और टूल-विशिष्ट पेजिंग कंट्रोल्स (उदाहरण के लिए get_file में line_start/line_end) का उपयोग करें।
  8. टूल मार्गदर्शन के लिए ask_maguyva का उपयोग करें: टूल चुनने की सलाह और उदाहरणों के लिए ask_maguyva को operation="guidance" और query="tool_selection" के साथ कॉल करें। गणना और स्ट्रिंग रूपांतरण के लिए अपने स्थानीय टूल्स इस्तेमाल करें।
  9. संपादन से पहले और बाद में प्रभाव सत्यापित करें: किसी साझा सिंबल को बदलने से पहले dependency_search को analysis_type="impact" के साथ कॉल करें (या PR/diff के प्रभाव के लिए changed_paths दें), ताकि ब्लास्ट रेडियस दिखे। बदलाव के बाद targets और/या changed_paths के साथ verify_after_edit=true सेट करें, ताकि इंडेक्स किए गए ग्राफ़ की संक्षिप्त दोबारा जाँच हो सके। यह उन स्थानीय बदलावों को नहीं पढ़ता जिनका कमिट नहीं हुआ है, और न ही स्थानीय टेस्ट की जगह लेता है। नतीजों को नए रिविज़न का प्रमाण मानने से पहले indexed_commit_sha और इंडेक्स कितना अद्यतन है, यह जाँचें।

परफ़ॉर्मेंस विशेषताएँ

#
ऑपरेशन प्रदर्शन नोट्स
सिमेंटिक सर्च इसमें क्वेरी का वेक्टर निरूपण बनाना और वेक्टर रिट्रीवल शामिल हैं। देरी दोनों कार्यों पर निर्भर करती है।
टेक्स्ट सर्च सामग्री की अनुमानित मिलान वाली खोज में आगे के पेज ज़्यादा संभावित परिणाम लाते हैं। path_filter और language_filter से क्वेरी सीमित करें।
स्ट्रक्चरल सर्च इंडेक्स किए गए AST नोड्स खोजता है। कोई विशिष्ट प्रीसेट या पैटर्न इस्तेमाल करें और परिणामों की संख्या सीमित रखें।
डिपेंडेंसी सर्च लागत डेप्थ के अनुसार बढ़ती है — जब तक मल्टी-हॉप संदर्भ की आवश्यकता न हो, depth="shallow" को प्राथमिकता दें; per_hop_limit फ़ैन-आउट को सीमित करता है
फ़ाइल रिट्रीवल line_start/line_end या max_tokens से ज़रूरी हिस्सा पढ़ें और कटे हुए कंटेंट के लिए लौटाए गए निरंतरता मेटाडेटा का इस्तेमाल करें।
रिपॉज़िटरी कॉन्टेक्स्ट हर टूल कॉल में रिपॉज़िटरी की पहचान की जाती है। किसी खास रिपॉज़िटरी की ज़रूरत हो तो repository स्पष्ट रूप से दें।
ask_maguyva (guidance / evaluate) रिपॉज़िटरी इंडेक्स से क्वेरी किए बिना MCP सर्वर में चलता है।

एरर हैंडलिंग

#

टूल रिस्पॉन्स के सबसे ऊपरी स्तर पर साझा स्टेटस फ़ील्ड और टूल-विशिष्ट डेटा फ़ील्ड होते हैं। खोज results लौटाती है; get_file content लौटाता है। साझा फ़ील्ड में शामिल हैं:

  • status: स्ट्रिंग — "success" या "error"। घटे हुए मिलान और इंडेक्स ताज़गी के संकेत अपने अलग फ़ील्ड में रहते हैं: metadata के अंतर्गत metadata.resolution_reason, और repository_context के info एक्शन के शीर्ष स्तर पर index_freshness.status।
  • timing_ms: टूल को चलाने में लगा समय, मिलीसेकंड में
  • applied_filters: ऑपरेशन के लिए दर्ज किए गए वास्तविक अनुरोध पैरामीटर
  • error: जब status, "error" हो, तब त्रुटि संदेश की स्ट्रिंग; इसमें रिकवरी का मार्गदर्शन भी हो सकता है।
  • metadata: ऑपरेशन के बारे में अतिरिक्त जानकारी (राउटिंग, कैशिंग, पैरामीटर समायोजन)
  • pagination: कर्सर से पेजिनेट किए गए संग्रहों के रिस्पॉन्स में मौजूद — इसमें has_more और next_cursor होते हैं। रैंक की गई सर्च विंडो सीमित top-K नतीजे देती हैं, संपूर्ण पेजिनेट किए गए संग्रह नहीं।

किसी टूल का पेलोड प्रोसेस करने से पहले status फ़ील्ड जाँचें — इसके मान "success" या "error" होते हैं। MCP/JSON-RPC ट्रांसपोर्ट और रिक्वेस्ट-वैलिडेशन एरर भी संभालें, जो टूल पेलोड बनने से पहले ही आ सकते हैं। घटे हुए मिलान या ताज़गी के संकेतों के लिए उनके अपने फ़ील्ड पढ़ें: metadata के अंतर्गत metadata.resolution_reason, या repository_context के info एक्शन के शीर्ष स्तर पर index_freshness.status (known/partial/unknown/unavailable)।

शुरुआत करना

#
  1. MCP क्लाइंट कॉन्फ़िगर करें: अपने MCP क्लाइंट को Maguyva सर्वर एंडपॉइंट की ओर इंगित करें
  2. रिपॉज़िटरी एक्सेस सत्यापित करें: API कुंजी के पास उपलब्ध रिपॉज़िटरी देखने के लिए repository_context के साथ list या info कॉल करें
  3. सर्च करना शुरू करें: intelligent_search से शुरुआत करें और ज़रूरत के अनुसार स्पेशलाइज़्ड टूल्स प्रयोग करें
  4. टूल्स को मिलाएँ: व्यापक कोड विश्लेषण के लिए कई टूल्स को साथ में उपयोग करें

विस्तृत इंटीग्रेशन निर्देशों के लिए, इंस्टॉलेशन गाइड देखें।

संबंधित

आगे पढ़ें