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

MCP API संदर्भ

सभी 11 कस्टमर-फ़ेसिंग Maguyva MCP टूल्स के लिए पूरा संदर्भ। हर टूल में पैरामीटर, उपयोग मार्गदर्शन, और बेस्ट-फ़ॉर सिफ़ारिशें शामिल हैं।

API अवलोकन#

Maguyva MCP API फ़िलहाल 4 मुख्य श्रेणियों में 11 कस्टमर-फ़ेसिंग टूल्स प्रदान करता है:

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

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

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

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

सभी MCP टूल्स यह रिपॉज़िटरी आइडेंटिफ़ायर फ़ॉर्मैट इस्तेमाल करते हैं:

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

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

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

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

सभी सर्च टूल्स प्रोग्रामिंग भाषा के आधार पर रिज़ल्ट फ़िल्टर करने का सपोर्ट देते हैं:

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

API संदर्भ 22 जुलाई 2026 को सोर्स से जनरेट किया गया।

मुख्य खोज टूल#

intelligent_searchस्टेबल

किसी भी कोडबेस प्रश्न के लिए यहां से प्रारंभ करें। इसे एक प्राकृतिक-भाषा क्वेरी दें (उदाहरण के लिए "ऑथ कैसे काम करता है", "बिलिंग कहां संभाली जाती है") और यह अनुक्रमित रेपो के सिमेंटिक, प्रतीक, संरचनात्मक और निर्भरता खोज में ऑटो-रूट करता है। अन्वेषण और योजना के लिए इसे Explore एजेंट और Grep/Glob से अधिक प्राथमिकता दें - यह फ़ाइलों को स्कैन करने के बजाय एक ही बार में पूरे अनुक्रमित रेपो को खोजता है।

पैरामीटर:

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

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

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

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

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

semantic_searchस्टेबल

कोड को अर्थ के आधार पर खोजें, सटीक पाठ के आधार पर नहीं। जब आप कीवर्ड या प्रतीक का नाम नहीं जानते हों तो "पुनः प्रयास तर्क" या "उपयोगकर्ता ऑनबोर्डिंग प्रवाह" जैसे वैचारिक प्रश्नों के लिए उपयोग करें। महत्व के आधार पर क्रमबद्ध सबसे प्रासंगिक कोड खंड लौटाता है। जब खोज वैचारिक हो तो ग्रेप को प्राथमिकता दें।

पैरामीटर:

queryआवश्यक
टाइप
str
विवरण
खोज क्वेरी (वैचारिक, अर्थ-आधारित)
repositoryवैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। उत्तर में कौन‑सी रिपॉज़िटरी उपयोग हुई है, यह दिखेगा।
limitवैकल्पिक
टाइप
int
डिफ़ॉल्ट
5
विवरण
इस रैंक किए गए top-K विंडो में अधिकतम परिणाम
similarity_thresholdवैकल्पिक
टाइप
float
डिफ़ॉल्ट
0.6
विवरण
न्यूनतम समानता स्कोर
language_filterवैकल्पिक
टाइप
str
विवरण
भाषा फ़िल्टर (python, typescript, आदि)
path_filterवैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी-सापेक्ष प्रीफ़िक्स (उदा., 'src/services/') या ग्लोब (उदा., '*.py', 'tree_sitter_queries/**/*.scm'); ये सर्वर-साइड फ़िल्टरिंग के बाद लागू होते हैं।
boost_by_importanceवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
वैकल्पिक (वैकल्पिक): PageRank centrality के अनुसार पुनः रैंक करें (एजेंट-सुरक्षित रैंकिंग के लिए डिफ़ॉल्ट रूप से बंद; आर्किटेक्चर टूर के लिए सक्षम करें)
branchवैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड (डिफ़ॉल्ट: repository पैराम या main)
include_contentवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
true
विवरण
परिणामों में चंक कंटेंट शामिल करें
graph_viewवैकल्पिक
टाइप
Literal[dependency, type, data_flow, control_flow]
डिफ़ॉल्ट
dependency
विवरण
मेट्रिक्स के लिए graph view

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

  • वैचारिक क्वेरी ("how does auth work?", "caching strategy")
  • पैकेजों के बीच समानता खोज

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

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

text_pattern_searchस्टेबल

इंडेक्स्ड कंटेंट खोजें। exact और regex मोड पूर्ण फाइल/blob कॉर्पस को grep करते हैं; fuzzy कंटेंट मोड सीमित सिमेंटिक चंक कॉर्पस खोजता है। फ़ाइल और सिंबल स्कोप केवल fuzzy के लिए उपलब्ध हैं। स्थानीय डिस्क पर मौजूद डाइरेक्टरी के लिए तंग खोज हेतु स्थानीय Grep उपयोग करें।

पैरामीटर:

queryआवश्यक
टाइप
str
विवरण
खोजने के लिए टेक्स्ट पैटर्न
repositoryवैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। उत्तर में कौन‑सी रिपॉज़िटरी उपयोग हुई है, यह दिखेगा।
modeवैकल्पिक
टाइप
Literal[fuzzy, exact, regex]
डिफ़ॉल्ट
exact
विवरण
सर्च मोड
search_scopeवैकल्पिक
टाइप
Literal[content, symbols, files]
डिफ़ॉल्ट
content
विवरण
क्या खोजें
limitवैकल्पिक
टाइप
int
डिफ़ॉल्ट
5
विवरण
इस पेज में लौटाए गए अधिकतम परिणाम
offsetवैकल्पिक
टाइप
int
विवरण
पदावनत (पदावनत) संगतता ऑफ़सेट। pagination.next_cursor से cursor को प्राथमिकता दें।
cursorवैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से अपारदर्शी cursor। इसे अपरिवर्तित पास करें और query तथा फ़िल्टर अपरिवर्तित रखें।
language_filterवैकल्पिक
टाइप
str
विवरण
भाषा फ़िल्टर
path_filterवैकल्पिक
टाइप
str
विवरण
फ़ाइल पाथ प्रीफ़िक्स द्वारा फ़िल्टर करें
case_sensitiveवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
केस-सेंसिटिव मिलान
branchवैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
fuzzy_algorithmवैकल्पिक
टाइप
Literal[hybrid, trigram, levenshtein]
डिफ़ॉल्ट
hybrid
विवरण
फज़ी मिलान एल्गोरिद्म
thresholdवैकल्पिक
टाइप
float
डिफ़ॉल्ट
0.05
विवरण
फज़ी के लिए न्यूनतम समानता थ्रेशोल्ड
semantic_fallbackवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
अगर परिणाम नहीं मिले तो सिमेंटिक सर्च पर फ़ॉलबैक करें

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

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

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

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

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

structural_searchस्टेबल

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

पैरामीटर:

repositoryवैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। उत्तर में कौन‑सी रिपॉज़िटरी उपयोग हुई है, यह दिखेगा।
presetवैकल्पिक
टाइप
Literal[functions, classes, methods, imports, variables]
विवरण
पसंदीदा संरचनात्मक चयनकर्ता। क्रॉस-लैंग्वेज AST नोड प्रकारों में विस्तृत होता है — functions (भाषाओं में function/arrow/method परिभाषाएँ); classes (class/struct/impl परिभाषाएँ); 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= को प्राथमिकता दें।
name_patternवैकल्पिक
टाइप
str
विवरण
सिंबल नाम पैटर्न (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
डिफ़ॉल्ट
20
विवरण
इस पेज में लौटाए गए अधिकतम परिणाम
offsetवैकल्पिक
टाइप
int
विवरण
पदावनत (पदावनत) संगतता ऑफ़सेट। pagination.next_cursor से cursor को प्राथमिकता दें।
cursorवैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से अपारदर्शी cursor। इसे अपरिवर्तित पास करें और query तथा फ़िल्टर अपरिवर्तित रखें।
path_filterवैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी-सापेक्ष प्रीफ़िक्स या ग्लोब (उदा., 'src/pipeline/', '*.py', 'tree_sitter_queries/**/*.scm'); ये सर्वर-साइड लागू होते हैं।
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
डिफ़ॉल्ट
विवरण
जानबूझकर उन्नत पथ, ltree, या कॉल फ़िल्टर (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name) का उपयोग करते समय true सेट करें। डिफ़ॉल्ट रूप से, false एजेंट इंटरफ़ेस को प्रीसेट पर केंद्रित रखता है। फ़्लैट प्रारूप में उन्नत कुंजियाँ अभी भी मेटाडेटा चेतावनी के साथ पश्चगामी संगतता के लिए काम करती हैं।
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स्टेबल

प्राथमिक blast-radius / ग्राफ़ सतह। वास्तविक call/import ग्राफ़ के माध्यम से "इसे क्या कॉल करता है?" / "यह क्या उपयोग करता है?" का उत्तर दें। संपादन से पहले प्रभाव के लिए: analysis_type="dependents" या analysis_type="impact" (incoming, impact के लिए shallow डिफ़ॉल्ट), डिफ़ॉल्ट रूप से include_metrics=false (centrality + refactor_risk के लिए ऑप्ट इन करें)। PR/diff प्रभाव (P1-8): changed_paths और/या patch (यूनिफ़ाइड diff) पास करें — यह प्रति पथ सिंबल रिज़ॉल्व करता है और सिंबल नाम की आवश्यकता के बिना एक संक्षिप्त shallow-incoming dependents पेलोड लौटाता है। संपादन के बाद, प्रभावित सिंबल की संक्षिप्त बहु-मूल पुनः-क्वेरी के लिए targets और/या changed_paths के साथ verify_after_edit=true सेट करें। dependencies, centrality, और orphans को भी समर्थन करता है। analyze_dependencies impact पथ का एक पतला उपनाम है — नए एजेंट के लिए इस टूल को प्राथमिकता दें।

पैरामीटर:

repositoryवैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। उत्तर में कौन‑सी रिपॉज़िटरी उपयोग हुई है, यह दिखेगा।
queryवैकल्पिक
टाइप
str
विवरण
सिंबल नाम या खोज शब्द
targetवैकल्पिक
टाइप
str
विवरण
सिंबल नाम (query के लिए उपनाम)
changed_pathsवैकल्पिक
टाइप
list[str]
विवरण
PR/diff प्रभाव (डिफ़ॉल्ट) के लिए रेपो-सापेक्ष पथ या, verify_after_edit=true के साथ, संपादन के बाद जड़ों को सत्यापित करें। PR/diff: प्रति पथ प्रतीकों को हल करता है और उथले आने वाले आश्रितों को चलाता है; patch= के साथ जोड़ा जा सकता है। सत्यापित करें: सत्यापित जड़ों के रूप में प्रति पथ 5 प्रतीकों तक का समाधान करता है (सत्यापन मोड के अंदर नीचे छाया हुआ है)। PR/diff प्रभाव के लिए query/target की आवश्यकता नहीं है।
patchवैकल्पिक
टाइप
str
विवरण
PR/diff प्रभाव: एकीकृत अंतर / गिट पैच टेक्स्ट। पथ diff --git / --- / +++ हेडर से पार्स किए गए हैं; changed_paths के समान कॉम्पैक्ट प्रभाव पथ।
analysis_typeवैकल्पिक
टाइप
Literal[centrality, dependencies, dependents, impact, orphans]
डिफ़ॉल्ट
dependencies
विवरण
विश्लेषण मोड। impact = blast radius (incoming dependents; depth छोड़ने पर shallow गहराई)। dependents भी impact का उत्तर देता है। जब changed_paths या patch सेट हो, तो विश्लेषण PR/diff impact पर बाध्य हो जाता है। centrality/orphans को लक्ष्य की आवश्यकता नहीं है।
depthवैकल्पिक
टाइप
Literal[shallow, balanced, deep]
डिफ़ॉल्ट
balanced
विवरण
ट्रैवर्सल गहराई। analysis_type=impact और PR/diff impact के लिए प्रभावी डिफ़ॉल्ट shallow है जब तक कि आप depth स्पष्ट रूप से सेट न करें।
limitवैकल्पिक
टाइप
int
डिफ़ॉल्ट
20
विवरण
इस पेज में लौटाए गए अधिकतम परिणाम
offsetवैकल्पिक
टाइप
int
विवरण
पदावनत (पदावनत) संगतता ऑफ़सेट। pagination.next_cursor से cursor को प्राथमिकता दें।
cursorवैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से अपारदर्शी cursor। इसे अपरिवर्तित पास करें और query तथा फ़िल्टर अपरिवर्तित रखें।
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
डिफ़ॉल्ट
विवरण
ट्रैवर्सल परिणामों से जेनरेट की गई घोषणाओं के साथ-साथ बिल्ड, कवरेज, कैश, सोर्स-मैप और मिनिफाइड आर्टिफैक्ट पथों को बाहर निकालें
include_module_symbolsवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
डिफ़ॉल्ट रूप से, false ग्राफ़ किनारों को बाहर कर देता है जब from_name या to_name सिंथेटिक __module__ प्रतीक (मॉड्यूल-स्तरीय शोर) होता है। आश्रित और निर्भरता संबंधों के परिणामों में मॉड्यूल-स्तरीय किनारों को शामिल करने के लिए true सेट करें।
branchवैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
per_hop_limitवैकल्पिक
टाइप
int
विवरण
प्रति हॉप अधिकतम संबंध (1-300)
include_metricsवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
परिणाम पंक्तियों पर वैकल्पिक (वैकल्पिक) ग्राफ़ मेट्रिक्स (refactor_risk के साथ संक्षिप्त)। min_centrality>0 होने पर मेट्रिक्स आंतरिक रूप से भी प्राप्त किए जाते हैं लेकिन इसके true न होने तक नहीं लौटाए जाते।
metrics_detailवैकल्पिक
टाइप
Literal[summary, full]
डिफ़ॉल्ट
summary
विवरण
जब include_metrics=true: summary (डिफ़ॉल्ट) निर्णय संकेत लौटाता है + refactor_risk; full बड़ा क्यूरेटेड मीट्रिक सेट लौटाता है
include_edge_metadataवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
कच्चे किनारे का मेटाडेटा और वज़न (बड़ा) शामिल करें। कॉम्पैक्ट इम्पैक्ट पेलोड इसे बंद कर देते हैं।
symbol_typesवैकल्पिक
टाइप
list[str]
विवरण
लौटाए गए सिंबल को प्रकार से फ़िल्टर करें (function, class, method, आदि)
exact_matchवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
सटीक सिंबल नाम मिलान आवश्यक करें (केस-इनसेंसिटिव)। फ़ज़ी मिलान अक्षम करता है
find_similar_patternsवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
समान उपयोग पैटर्न खोजें
min_centralityवैकल्पिक
टाइप
float
डिफ़ॉल्ट
0
विवरण
न्यूनतम PageRank स्कोर। फ़िल्टरिंग के लिए मेट्रिक्स आंतरिक रूप से प्राप्त किए जाते हैं; graph_metrics केवल तभी लौटाए जाते हैं जब include_metrics=true हो।
graph_viewवैकल्पिक
टाइप
Literal[dependency, type, data_flow, control_flow]
डिफ़ॉल्ट
dependency
विवरण
ट्रैवर्सल संबंध डिफ़ॉल्ट, मेट्रिक्स, और centrality रैंकिंग के लिए उपयोग किया गया graph view; orphan विश्लेषण सभी दृश्यों में गणना किया जाता है
verify_after_editवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
P2-7 पोस्ट-एडिट सत्यापन मोड: एक कॉम्पैक्ट मल्टी-रूट प्रतिक्रिया में हाल ही में संपादित प्रतीकों के लिए अनुक्रमित प्रभाव ग्राफ़ को दोबारा क्वेरी करें। targets और/या changed_paths (या target/query) की आवश्यकता है। उथले आने वाले आश्रितों के लिए डिफ़ॉल्ट; परिणाम अनुक्रमित ग्राफ़ को प्रतिबिंबित करते हैं (लाइव संपादन में देरी हो सकती है)। सत्य होने पर, उसी changed_paths पर PR/diff प्रभाव को प्राथमिकता दी जाती है।
targetsवैकल्पिक
टाइप
list[str]
विवरण
जब 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 क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। उत्तर में कौन‑सी रिपॉज़िटरी उपयोग हुई है, यह दिखेगा।
scopeवैकल्पिक
टाइप
Literal[definitions, references, both]
डिफ़ॉल्ट
both
विवरण
खोज स्कोप: definitions|references|both
limitवैकल्पिक
टाइप
int
डिफ़ॉल्ट
15
विवरण
इस पेज में लौटाए गए अधिकतम परिणाम
offsetवैकल्पिक
टाइप
int
विवरण
पदावनत (पदावनत) संगतता ऑफ़सेट। pagination.next_cursor से cursor को प्राथमिकता दें।
cursorवैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से अपारदर्शी cursor। इसे अपरिवर्तित पास करें और query तथा फ़िल्टर अपरिवर्तित रखें।
find_similarवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
समान सिंबल नाम भी शामिल करें
include_metricsवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
सेंट्रालिटी मेट्रिक्स शामिल करें
metrics_detailवैकल्पिक
टाइप
Literal[summary, full]
डिफ़ॉल्ट
summary
विवरण
जब include_metrics=true: summary (डिफ़ॉल्ट) निर्णय संकेत लौटाता है + refactor_risk; full बड़ा क्यूरेटेड मीट्रिक सेट लौटाता है
path_filterवैकल्पिक
टाइप
str
विवरण
पथ ग्लोब (उदा., 'src/', '*.py')
branchवैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
symbol_typeवैकल्पिक
टाइप
Literal[function, class, variable, method, constant, module, interface, type]
विवरण
सिंबल प्रकार फ़िल्टर
high_impactवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
आर्किटेक्चरल रूप से महत्वपूर्ण सिंबल ब्राउज़ करें (symbol_name छोड़ें)। डिफ़ॉल्ट मोड लोकप्रियता है (शीर्ष PageRank दशमक माइनस उपयोगिता मेगा-हब)। संधि/सेतु कट-वर्टिसेस के लिए high_impact_mode=risk सेट करें।
high_impact_modeवैकल्पिक
टाइप
Literal[popularity, risk]
डिफ़ॉल्ट
popularity
विवरण
जब high_impact=true: लोकप्रियता = शीर्ष PageRank डेसिल माइनस उपयोगिता मेगा-हब/मॉड्यूल; जोखिम = अभिव्यक्ति बिंदु SMV bridge_count फिर k_core द्वारा क्रमबद्ध (संरचनात्मक रिफैक्टर जोखिम, हब लोकप्रियता नहीं)
in_cycleवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
केवल निर्भरता चक्रों में मौजूद सिंबल फ़िल्टर करें
exclude_test_pathsवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
true
विवरण
ग्राफ़ मेट्रिक्स द्वारा ब्राउज़ करते समय, रैंकिंग से पहले परीक्षण, fixtures, तृतीय-पक्ष कोड और उदाहरणों को बाहर कर दें। नामित प्रतीक द्वारा लुकअप अपरिवर्तित है.

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

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

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

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

analyze_dependenciesस्टेबल

dependency_search (dependents/incoming) के माध्यम से blast-radius के लिए उपनाम। नए एजेंट के लिए analysis_type="dependents" या "impact" के साथ dependency_search को प्राथमिकता दें। लेगेसी बहु-हॉप impact प्रतिक्रिया आकार (ग्राफ़, connection_summary, refactor_risk के साथ वैकल्पिक मेट्रिक्स) बनाए रखता है। संबंध परिवार को स्कोप करने के लिए graph_view का उपयोग करें: dependency (डिफ़ॉल्ट), type, data_flow, control_flow।

पैरामीटर:

repositoryवैकल्पिक
टाइप
str
विवरण
रिपॉज़िटरी owner/repo[:branch] के रूप में। वैकल्पिक — जब आपका MCP क्लाइंट अनुरोध-स्तरीय डिफ़ॉल्ट देता है (यदि दिया गया हो) या कुंजी केवल एक ही रिपॉज़िटरी तक पहुँच सकती है, तो छोड़ दें; किसी अन्य इंडेक्स्ड रिपॉज़िटरी को लक्षित करने के लिए ही इसे स्पष्ट रूप से पास करें। उत्तर में कौन‑सी रिपॉज़िटरी उपयोग हुई है, यह दिखेगा।
targetआवश्यक
टाइप
str
विवरण
विश्लेषण हेतु सिंबल नाम
depthवैकल्पिक
टाइप
Literal[shallow, balanced, deep]
डिफ़ॉल्ट
balanced
विवरण
विश्लेषण गहराई (उपनाम समर्थित: auto, shallow/quick=1, balanced/medium=2, deep/thorough=3)
limitवैकल्पिक
टाइप
int
डिफ़ॉल्ट
10
विवरण
इस पेज में लौटाए गए अधिकतम परिणाम
offsetवैकल्पिक
टाइप
int
विवरण
पदावनत (पदावनत) संगतता ऑफ़सेट। pagination.next_cursor से cursor को प्राथमिकता दें।
cursorवैकल्पिक
टाइप
str
विवरण
pagination.next_cursor से अपारदर्शी cursor। इसे अपरिवर्तित पास करें और query तथा फ़िल्टर अपरिवर्तित रखें।
directionवैकल्पिक
टाइप
Literal[incoming, outgoing, both]
डिफ़ॉल्ट
incoming
विवरण
ट्रैवर्सल दिशा: 'outgoing' = यह सिंबल किस पर निर्भर है, 'incoming' = इस सिंबल पर क्या निर्भर है, 'both' = पूरा संदर्भ।
relationship_typesवैकल्पिक
टाइप
list[str]
विवरण
एज प्रकारों से फिल्टर (CALL, IMPORT, INHERITS_FROM, आदि). यदि दिया गया हो तो यह graph_view-उत्पन्न डिफ़ॉल्ट को ओवरराइड कर देता है।
graph_viewवैकल्पिक
टाइप
Literal[dependency, type, data_flow, control_flow]
डिफ़ॉल्ट
dependency
विवरण
ग्राफ़ view: यह डिफ़ॉल्ट ट्रैवर्सल edge प्रकार और include_metrics=true पर किस view के मेट्रिक्स इस्तेमाल होंगे तय करता है। 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 स्पष्ट न दिया गया हो तभी graph_view को relationship_types का डिफ़ॉल्ट माना जाता है। यह dependency_search के graph_view नाम के साथ संगतता बनाए रखता है।
path_filterवैकल्पिक
टाइप
str
विवरण
फ़ाइल पथ प्रीफ़िक्स द्वारा लक्ष्य सिंबल रिज़ॉल्यूशन सीमित करें; लौटाए गए ग्राफ़ संबंध उस पथ के बाहर तक जा सकते हैं
language_filterवैकल्पिक
टाइप
str
विवरण
परिणामों को किसी भाषा तक सीमित करें
branchवैकल्पिक
टाइप
str
विवरण
ब्रांच ओवरराइड
per_hop_limitवैकल्पिक
टाइप
int
विवरण
प्रति हॉप अधिकतम संबंध (1-300)
include_metricsवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
परिणामों में ग्राफ़ मेट्रिक्स शामिल करें, प्रत्येक व्युत्पन्न 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
डिफ़ॉल्ट
विवरण
कच्चे किनारे का मेटाडेटा और वज़न शामिल करें। डिफ़ॉल्ट रूप से अक्षम क्योंकि एक्सट्रैक्टर मेटाडेटा बड़ा हो सकता है; सक्षम होने पर संवर्धन कवरेज की सूचना दी जाती है।
exclude_test_pathsवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
true
विवरण
डिफ़ॉल्ट true: लौटाए गए ग्राफ़ किनारों से परीक्षण, स्थिरता, विक्रेता और उदाहरण पथ को बाहर करें। उन्हें शामिल करने के लिए false सेट करें।
include_module_symbolsवैकल्पिक
टाइप
bool
डिफ़ॉल्ट
विवरण
डिफ़ॉल्ट रूप से, false ग्राफ़ किनारों को बाहर कर देता है जब from_name या to_name सिंथेटिक __module__ प्रतीक होता है। मॉड्यूल-स्तरीय किनारों को शामिल करने के लिए true सेट करें।

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

  • पुराने कॉलर जो पहले से इसके रिस्पॉन्स आकार (graph, connection_summary) से जुड़े हैं

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

  • नए एजेंट लूप — dependency_search को प्राथमिकता दें, जो वही ट्रैवर्सल कोर साझा करता है

get_task_contextस्टेबल

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

पैरामीटर:

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

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

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

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

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

get_fileस्टेबल

इंडेक्स की गई repo से पथ द्वारा फ़ाइल पढ़ें। डिस्क पर मौजूद फ़ाइलों के लिए स्थानीय Read टूल को प्राथमिकता दें — इसका उपयोग क्रॉस-repo या रिमोट लुकअप के लिए करें जहाँ फ़ाइल आपके वर्किंग ट्री में नहीं है। एक वैकल्पिक लाइन रेंज का समर्थन करता है; metadata.next_line_start से टोकन-कटी प्रतिक्रिया जारी रखें।

पैरामीटर:

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

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

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

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

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

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

repository_contextस्टेबल

उन रिपॉज़िटरीज़ की सूची बनाएँ जिन्हें आप खोज सकते हैं, या किसी एक की पहचान जानकारी प्राप्त करें (namespace/branch, indexed_commit_sha / इंडेक्स ताज़गी)। खोज टूल द्वारा स्वीकृत सटीक repo slug जानने के लिए एक बार action:"list" के साथ कॉल करें। (यदि आपकी कुंजी में एकल repo है, तो खोज टूल डिफ़ॉल्ट रूप से उसी का उपयोग करते हैं — आप इसे छोड़ सकते हैं।) namespace-व्यापी file/blob/edge गणनाएँ include_statistics=true के माध्यम से वैकल्पिक हैं।

पैरामीटर:

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

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

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

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

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

ask_maguyvaस्टेबल

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

पैरामीटर:

operationआवश्यक
टाइप
Literal[guidance, report_bug, request_feature, evaluate]
विवरण
प्राथमिक: guidance, report_bug, request_feature. केवल लेगेसी/कम्पैट: evaluate (नियतात्मक एक्सप्रेशन इंजन; प्राथमिक एजेंट वर्कफ़्लो का हिस्सा नहीं)।
queryवैकल्पिक
टाइप
str
विवरण
मार्गदर्शन विषय (उदा. tool_selection, semantic_search)। केवल लेगेसी evaluate के लिए: एक्सप्रेशन स्ट्रिंग।
descriptionवैकल्पिक
टाइप
str
विवरण
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 के मेंटेनर्स के लिए टिकाऊ बग रिपोर्ट और फ़ीचर अनुरोध

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

  • गणित/हैश/स्ट्रिंग गणना — evaluate ऑपरेशन केवल लीगेसी/बैक-कम्पैट है; लोकल होस्ट कंप्यूट को प्राथमिकता दें

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

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

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

ऑपरेशनप्रदर्शन नोट्स
सिमेंटिक सर्चसब-सेकंड, लेकिन हर बार एक लाइव एम्बेडिंग API कॉल शामिल होती है (कैश्ड नहीं) — वेक्टर क्वेरी के ऊपर अतिरिक्त लेटेंसी की अपेक्षा करें
टेक्स्ट सर्चexact/regex के लिए सब-सेकंड; फ़ज़ी कंटेंट सर्च क्लाइंट-साइड पेजिनेट होती है, इसलिए गहरे ऑफ़सेट अधिक महँगे पड़ते हैं — path_filter/language_filter से दायरा सीमित करें
स्ट्रक्चरल सर्चAST-इंडेक्स्ड — लागत रिज़ल्ट की मात्रा के अनुसार बढ़ती है, रिपॉज़िटरी के आकार के अनुसार नहीं
डिपेंडेंसी सर्चलागत डेप्थ के अनुसार बढ़ती है — जब तक मल्टी-हॉप संदर्भ की आवश्यकता न हो, depth="shallow" को प्राथमिकता दें; per_hop_limit फ़ैन-आउट को सीमित करता है
फ़ाइल रिट्रीवलएकल फ़ाइल के लिए लगभग-तुरंत — एक बड़े पुल के बजाय बड़ी फ़ाइलों को line_start/line_end या max_tokens से पेज करें
रिपॉज़िटरी कॉन्टेक्स्टनेमस्पेस रिज़ॉल्यूशन केवल प्रति-अनुरोध कैश होता है, कॉल्स के आर-पार नहीं — हर टूल इनवोकेशन फिर से रिज़ॉल्व करता है
ask_maguyva (guidance / evaluate)लगभग-तुरंत — बिना किसी डेटाबेस कॉल के इन-Worker चलता है

एरर हैंडलिंग#

सभी API मेथड एक स्ट्रक्चर्ड एनवलप लौटाते हैं:

  • status: स्ट्रिंग — "success" या "error"। डिग्रेडेड-मैच और फ्रेशनेस सिग्नल नेस्टेड फ़ील्ड्स में होते हैं, जैसे repository_context पर metadata.resolution_reason या metadata.index_freshness.status।
  • tool: उस टूल का नाम जिसने रिस्पॉन्स जनरेट किया
  • data: सफल होने पर रिज़ल्ट पेलोड (संरचना टूल के अनुसार अलग होती है)
  • error: जब status, "error" हो तब स्ट्रक्चर्ड एरर ऑब्जेक्ट — इसमें type, message, suggestions, और recovery_actions शामिल हैं
  • metadata: ऑपरेशन के बारे में अतिरिक्त जानकारी (राउटिंग, कैशिंग, पैरामीटर समायोजन)
  • pagination: लिस्ट रिस्पॉन्स पर मौजूद — इसमें has_more और next_cursor शामिल हैं

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

शुरुआत करना#

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

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