Hoppa till innehåll

MCP API-referens

Utforska de 11 MCP-verktygen i Maguyva, deras parametrar och när du bör använda dem. Kontrollera svaret från tools/list i din anslutna klient för tillgängliga argument.

API-översikt

#

Verktygen är indelade i 4 kategorier:

  • Grundläggande sökverktyg - Avancerade sökfunktioner i hela din kodbas
  • Strukturella verktyg & grafverktyg - AST-frågor, symboluppslagning och beroendeanalys
  • Kodanalysverktyg - Djup kodanalys och relationskartläggning
  • System- och hjälpverktyg - Kodarkivskontext, verktygsvägledning och återkoppling

För verktyg som tar emot ett kodarkiv, använd detta format för repository-identifierare: "owner/repo:branch". Grenen är main om inget annat anges.

Utelämna repository när MCP-klienten anger ett anropsspecifikt standardrepo eller när nyckeln har åtkomst till exakt ett repo; ange det annars uttryckligen. Använd repository_context(action="info", repository="owner/repo") för att se hur ett repo matchas.

Format för repository-parameter

#

Använd dessa format när du anger ett kodarkiv:

  • Med gren: "owner/repo:branch" - t.ex., "owner/repository:develop"
  • Standardgren: "owner/repo" - använder main-grenen när ingen gren anges "owner/repository"
  • Standard för anrop eller enda repo: Utelämna repot när MCP-klienten anger ett anropsspecifikt standardrepo eller när nyckeln har åtkomst till exakt ett repo; ange det annars uttryckligen

Exempelprompter:

Fråga om ett specifikt repo:  "Sök i owner/my-repo efter autentiseringsmiddleware"
Lista tillgängliga repor:     "Vilka arkiv kan denna Maguyva-nyckel komma åt?"
Åsidosätt för en fråga:       "Sök owner/other-repo:develop efter autentiseringsmönster"

Språkfiltrering

#

Använd language_filter i söklägen som stöder det. Välj search_scope="content" för text_pattern_search; använd scope="semantic" utan startpunkter eller relaterad kontext för get_task_context.

  • language_filter="python" - Filtrera till endast Python-filer
  • language_filter="typescript" - Filtrera till endast TypeScript-filer
  • Skiftlägeskänsligt: Använd gemena språknamn
  • Standard: Tom sträng (ingen filtrering) - returnerar resultat från alla språk
  • Språktäckning: Språkfilter fungerar över alla 285+ av de språk och textbaserade teknologier som stöds. Se kompatibilitet för den fullständiga listan. 
"Hitta autentiseringsmiddleware endast i Python-filer"
"Sök efter databasanslutningar i TypeScript"

API-referens genererad från källkod 21 oktober 2026.

Grundläggande sökverktyg

#

intelligent_search Stabil

Börja här för alla frågor om kodbasen. Standardläget auto/balanced skickar frågor som med hög säkerhet identifieras som definitionsfrågor till struktursökning, frågor om referenser eller påverkan till grafen och frågor om exakta träffar till textsökning. Övriga frågor använder semantisk betydelse och indexerad text. Använd mode=hybrid eller auto med quality=thorough för att begära alla fyra sökmodaliteter; ett uttryckligen valt läge har företräde framför quality. language_filter utesluter graf från auto/hybrid och avvisar uttryckligt mode=graph. Använd detta hellre än Grep/Glob när du inte redan känner till sökvägen.

Parametrar:

query Obligatorisk
Typ
str minLength=1
Beskrivning
Sökfråga
repository Valfri
Typ
str
Beskrivning
Repo som owner/repo[:branch]. Valfritt — utelämna för att använda klientens anropsspecifika standardrepo (om ett sådant anges) eller det enda tillgängliga repot; ange det uttryckligen bara för att välja ett annat indexerat repo. Exakt indexerade grenar prioriteras; en otillgänglig gren kan falla tillbaka till main eller den enda tillgängliga grenen. Svarets metadata visar den begärda och den faktiskt använda identiteten och varnar när detta sker.
mode Valfri
Typ
Literal[auto, hybrid, semantic, text, structural, ast, graph]
Standard
auto
Beskrivning
Sökläge
limit Valfri
Typ
int minimum=1, maximum=50
Standard
10
Beskrivning
Max antal resultat i detta rankade top-K-fönster
language_filter Valfri
Typ
str
Beskrivning
Språkfilter
path_filter Valfri
Typ
str
Beskrivning
Filtrerar sökkandidater efter filsökvägens prefix. Angränsande noder i grafen och bifogad communitykontext kan innehålla filer utanför detta prefix.
boost_by_importance Valfri
Typ
bool
Standard
false
Beskrivning
Opt-in: sortera om efter centralitet med symbolspecifika grafmetriker (is_articulation_point, bridge_count, k_core, centrality med mera). Avstängt som standard för agentsäker rankning (globala hubbar kan dränka implementationsträffar); aktivera för arkitekturrundturer. Gäller alla 4 modaliteter när varje resultat har symbolkoppling.
branch Valfri
Typ
str
Beskrivning
Grenöverstyrning
quality Valfri
Typ
Literal[quick, balanced, thorough]
Standard
balanced
Beskrivning
Förinställd sökkvalitet
include_content Valfri
Typ
bool
Standard
true
Beskrivning
Inkludera innehåll i resultaten
explain_routing Valfri
Typ
bool
Standard
false
Beskrivning
Inkludera förklaring av routingbeslut
importance_weight Valfri
Typ
float minimum=0, maximum=1
Standard
0.3
Beskrivning
Vikt för betydelseförstärkning (0=ingen, 1=full)
orphans Valfri
Typ
bool
Standard
false
Beskrivning
Inkludera föräldralösa symboler (inga inkommande referenser)
include_community_context Valfri
Typ
bool
Standard
false
Beskrivning
Inkludera relaterade symboler från samma kodkluster
community_depth Valfri
Typ
int minimum=1, maximum=3
Standard
1
Beskrivning
Djup för utökning av kontext från kodklustret
graph_view Valfri
Typ
Literal[dependency, type, data_flow, control_flow]
Standard
dependency
Beskrivning
Grafvy för mätvärden
seed_symbol_ids Valfri
Typ
list[str] maxItems=20
Beskrivning
Tier-1-startpunkter för uppgiften: symbol-ID:n som är centrala för den aktuella uppgiften. När de anges rangordnas sammanslagna träffar efter närhet enligt Approach A, med avtagande vikt för större djup (exakt matchning mot startpunkten + steg längs grafkanter). Ett tillägg — utelämna för global rangordning.
seed_file_paths Valfri
Typ
list[str] maxItems=10
Beskrivning
Tier-1-startpunkter för uppgiften: indexerade filsökvägar som agenten har öppna eller just har redigerat. När de anges rangordnas sammanslagna träffar efter närhet i sökvägen med vikten 1/(1+d), som avtar med djupet (samma fil → samma katalog → närliggande paket). Ett tillägg — utelämna för global rangordning.

Bäst för:

  • Indexomfattande eller cold-start-utforskning när det är oklart vilket verktyg som är rätt
  • Sammanslagen rangordning över semantisk sökning, textsökning, strukturell sökning och grafsökning

Rekommenderas inte för:

  • Ett känt symbolnamn — använd find_symbol direkt
  • En känd sökväg på disk — använd lokal Read/Grep först

semantic_search Stabil

Hitta kod efter betydelse, inte exakt text. Använd för begreppsliga frågor som ”logik för återförsök” eller ”introduktionsflöde för användare” när nyckelord eller symbolnamn är okända. Returnerar relevanta fragment med begränsad filvariation; omrangering efter grafbetydelse aktiveras valfritt via boost_by_importance. Välj detta framför Grep vid begreppslig sökning.

Parametrar:

query Obligatorisk
Typ
str minLength=1
Beskrivning
Sökfråga (konceptuell, meningsbaserad)
repository Valfri
Typ
str
Beskrivning
Repo som owner/repo[:branch]. Valfritt — utelämna för att använda klientens anropsspecifika standardrepo (om ett sådant anges) eller det enda tillgängliga repot; ange det uttryckligen bara för att välja ett annat indexerat repo. Exakt indexerade grenar prioriteras; en otillgänglig gren kan falla tillbaka till main eller den enda tillgängliga grenen. Svarets metadata visar den begärda och den faktiskt använda identiteten och varnar när detta sker.
limit Valfri
Typ
int minimum=1, maximum=50
Standard
5
Beskrivning
Max antal resultat i detta rankade top-K-fönster
similarity_threshold Valfri
Typ
float minimum=0, maximum=1
Standard
0.6
Beskrivning
Minsta likhetspoäng
language_filter Valfri
Typ
str
Beskrivning
Språkfilter (python, typescript med flera)
path_filter Valfri
Typ
str
Beskrivning
Filtrera efter filsökvägsprefix
boost_by_importance Valfri
Typ
bool
Standard
false
Beskrivning
Valfritt: rangordna om efter normaliserad grafbetydelse per symbol (av som standard; begränsat till 1,5 gånger likheten).
branch Valfri
Typ
str
Beskrivning
Grenåsidosättning (standard: från repository-parametern eller main)
include_content Valfri
Typ
bool
Standard
true
Beskrivning
Inkludera kodfragmentens innehåll i resultaten
graph_view Valfri
Typ
Literal[dependency, type, data_flow, control_flow]
Standard
dependency
Beskrivning
Grafvy för mätvärden

Bäst för:

  • Konceptuella frågor ("hur fungerar auth?", "cachningsstrategi")
  • Likhetssökning över flera paket

Rekommenderas inte för:

  • Ett känt symbolnamn — använd find_symbol istället
  • Exakta strängar eller felmeddelanden — använd text_pattern_search

text_pattern_search Stabil

Sök i indexerat innehåll. exact och regex använder grep på hela fil-/blobkorpusen; fuzzy content söker i den begränsade korpusen av semantiska fragment. Områdena file och symbol stöder bara trigram — standardvärdet mode=exact omvandlas till fuzzy. Språk-, skiftläges- och egna tröskelinställningar kräver området content. Filtrering av sökvägar använder ett begränsat kandidatfönster och rapporterar ofullständig täckning. Använd lokal Grep för en snävt avgränsad katalog som redan finns på disk.

Parametrar:

query Obligatorisk
Typ
str minLength=1
Beskrivning
Textmönster att söka efter
repository Valfri
Typ
str
Beskrivning
Repo som owner/repo[:branch]. Valfritt — utelämna för att använda klientens anropsspecifika standardrepo (om ett sådant anges) eller det enda tillgängliga repot; ange det uttryckligen bara för att välja ett annat indexerat repo. Exakt indexerade grenar prioriteras; en otillgänglig gren kan falla tillbaka till main eller den enda tillgängliga grenen. Svarets metadata visar den begärda och den faktiskt använda identiteten och varnar när detta sker.
mode Valfri
Typ
Literal[fuzzy, exact, regex]
Standard
exact
Beskrivning
Sökläge. Regex körs med PostgreSQL:s avancerade/POSIX-syntax; använd \y för ordgränser (\b betyder backsteg). Mönster passerar även en JavaScript-säkerhetsvalidator, så PostgreSQL-specifika konstruktioner som infogade (?i)-flaggor avvisas; använd case_sensitive istället.
search_scope Valfri
Typ
Literal[content, symbols, files]
Standard
content
Beskrivning
Vad ska man söka
limit Valfri
Typ
int minimum=1, maximum=50
Standard
5
Beskrivning
Max antal resultat per sida utan cursor. Fortsättning använder sidstorleken som lagras i cursor; utelämna cursor för att börja med en annan limit.
offset Valfri
Typ
int minimum=0
Beskrivning
Föråldrad kompatibilitets-offset. Föredra cursor från pagination.next_cursor.
cursor Valfri
Typ
str
Beskrivning
Ogenomskinlig cursor från pagination.next_cursor. Skicka den oförändrad och håll query och filter oförändrade. Dess position och sidstorlek har företräde framför offset och limit.
language_filter Valfri
Typ
str
Beskrivning
Språkfilter
path_filter Valfri
Typ
str
Beskrivning
Filtrera efter filsökvägsprefix
case_sensitive Valfri
Typ
bool
Standard
false
Beskrivning
Skiftlägeskänslig matchning
branch Valfri
Typ
str
Beskrivning
Grenöverstyrning
fuzzy_algorithm Valfri
Typ
Literal[hybrid, trigram, levenshtein]
Standard
hybrid
Beskrivning
Algoritm för fuzzy-matchning
threshold Valfri
Typ
float minimum=0, maximum=1
Standard
0.05
Beskrivning
Minsta likhetströskel för fuzzy
semantic_fallback Valfri
Typ
bool
Standard
false
Beskrivning
Försöker med semantisk sökning efter en tom första lexikal sida; metadata.fallback_status skiljer mellan reservlägena used, empty och unavailable.

Bäst för:

  • Exakta strängar, felmeddelanden och regex
  • Trigram-fuzzy-matchning för nästan matchande text

Rekommenderas inte för:

  • En känd sökväg på disk — föredra lokal Grep
  • Konceptuella frågor — använd semantic_search

Strukturella verktyg och grafverktyg

#

structural_search Stabil

Använd helst preset=functions|classes|methods|imports|variables (eller fritt pattern=). Hitta kod utifrån AST-struktur, inte text. Filter på mellannivå: name_pattern, node_type, decorator, parent_child. Sökvägs-/ltree-/anropsfilter är avancerade; ange advanced=true när du använder dem medvetet. Annars tillämpas avancerade filter med en varning i metadata. Ange minst en strukturell väljare.

Parametrar:

repository Valfri
Typ
str
Beskrivning
Repo som owner/repo[:branch]. Valfritt — utelämna för att använda klientens anropsspecifika standardrepo (om ett sådant anges) eller det enda tillgängliga repot; ange det uttryckligen bara för att välja ett annat indexerat repo. Exakt indexerade grenar prioriteras; en otillgänglig gren kan falla tillbaka till main eller den enda tillgängliga grenen. Svarets metadata visar den begärda och den faktiskt använda identiteten och varnar när detta sker.
preset Valfri
Typ
Literal[functions, classes, methods, imports, variables]
Beskrivning
Föredragen strukturell selektor. Expanderas till språköverskridande AST-nodtyper — functions (funktions-/pil-/metoddefinitioner över språk); classes (class-/struct-/interface-deklarationer, typkroppar och implementationer); methods (metoddefinitioner, samt function_definition för språk utan metodnod); imports (import-/use-/include-satser); variables (variable-/let-/const-/static-deklarationer). Föredra framför fritt pattern/node_type för browse-liknande frågor.
pattern Valfri
Typ
str
Beskrivning
Ett fritt formulerat pattern fyller i saknade selectors (automatisk identifiering: 'def foo(' → node_type + name_pattern). Kan kombineras med preset; explicita selectors har företräde. Föredra preset= för bläddringsfrågor.
name_pattern Valfri
Typ
str maxLength=256
Beskrivning
Symbolnamnsmönster (skal-wildcard, avgränsat POSIX-regex eller fuzzy-text; max 256 tecken)
node_type Valfri
Typ
str
Beskrivning
AST-nodtyp (function_definition, class_definition med mera) — föredra preset= för vanliga former
decorator Valfri
Typ
str
Beskrivning
Filter för dekoratornamn
base_class Valfri
Typ
str
Beskrivning
Basklassfilter
language_filter Valfri
Typ
str
Beskrivning
Språkfilter (python, typescript med flera)
limit Valfri
Typ
int minimum=1, maximum=50
Standard
20
Beskrivning
Max antal resultat per sida utan cursor. Fortsättning använder sidstorleken som lagras i cursor; utelämna cursor för att börja med en annan limit.
offset Valfri
Typ
int minimum=0
Beskrivning
Föråldrad kompatibilitets-offset. Föredra cursor från pagination.next_cursor.
cursor Valfri
Typ
str
Beskrivning
Ogenomskinlig cursor från pagination.next_cursor. Skicka den oförändrad och håll query och filter oförändrade. Dess position och sidstorlek har företräde framför offset och limit.
path_filter Valfri
Typ
str
Beskrivning
Filtrera efter filsökvägsprefix
branch Valfri
Typ
str
Beskrivning
Grenöverstyrning
query_type Valfri
Typ
Literal[node_type, name_pattern, parent_child]
Beskrivning
Explicit frågetyp
parent_type Valfri
Typ
str
Beskrivning
Filter för den överordnade AST-nodens typ
relationship Valfri
Typ
Literal[parent, ancestor]
Standard
parent
Beskrivning
För parent_child-frågor: endast direkt överordnad nod eller valfri föregångare (använd ancestor för klassmetoder som är nästlade i en klasskropp eller ett block)
has_modifier Valfri
Typ
str
Beskrivning
Filtrera efter modifierare (export, async, static med flera)
advanced Valfri
Typ
bool
Standard
false
Beskrivning
Ange true när du medvetet använder avancerade sökvägs-/ltree-/anropsfilter (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Vid false tillämpas angivna avancerade filter med en varning i metadata. Använd helst preset= för vanliga strukturella frågor.
callee_text Valfri
Typ
str
Beskrivning
Avancerat — föredra preset=functions|classes|methods|imports|variables. Filter för callee-text i ett anropsuttryck. Sätt advanced=true när du avsiktligt använder path-/ltree-/call-filter.
callee_name Valfri
Typ
str
Beskrivning
Avancerat — föredra preset=functions|classes|methods|imports|variables. Filter för callee-namn i ett anropsuttryck. Sätt advanced=true när du avsiktligt använder path-/ltree-/call-filter.
field_role Valfri
Typ
str
Beskrivning
Avancerat — föredra preset=functions|classes|methods|imports|variables. Filter för AST-fältroll. Sätt advanced=true när du avsiktligt använder path-/ltree-/call-filter.
ltree_ancestor Valfri
Typ
str
Beskrivning
Avancerat — föredra preset=functions|classes|methods|imports|variables. Filter för AST-ltree-förfaderväg. Sätt advanced=true när du avsiktligt använder path-/ltree-/call-filter.
ltree_descendant Valfri
Typ
str
Beskrivning
Avancerat — föredra preset=functions|classes|methods|imports|variables. Filter för AST-ltree-avkomlingsväg. Sätt advanced=true när du avsiktligt använder path-/ltree-/call-filter.
definition_name Valfri
Typ
str
Beskrivning
Avancerat — föredra preset=functions|classes|methods|imports|variables. Filter för definitionsnamn. Sätt advanced=true när du avsiktligt använder path-/ltree-/call-filter.
min_depth Valfri
Typ
int
Beskrivning
Avancerat — föredra preset=functions|classes|methods|imports|variables. Minsta AST-djup. Sätt advanced=true när du avsiktligt använder path-/ltree-/call-filter.
max_depth Valfri
Typ
int
Beskrivning
Avancerat — föredra preset=functions|classes|methods|imports|variables. Högsta AST-djup. Sätt advanced=true när du avsiktligt använder path-/ltree-/call-filter.

Bäst för:

  • Struktur på AST-nivå: classes, decorators, function-/method-presets
  • Hitta kod efter form snarare än efter text

Rekommenderas inte för:

  • Fritext eller konceptuella frågor — använd semantic_search eller intelligent_search

dependency_search Stabil

Huvudverktyg för påverkansradie och grafer. Besvarar «vad anropar detta?» och «vad använder detta?» via den faktiska anrops-/importgrafen. För påverkan före ändring: analysis_type="dependents" eller analysis_type="impact" (inkommande, begränsat djup som standard för impact), med include_metrics=false som standard (aktivera för centralitet och refactor_risk). dependents/impact inkluderar production_callers som standard: unika användningsställen i produktionskod per slag (call, instantiate, value_reference för funktioner som skickas som värden), plus IMPORT-ställen, utan tester och med EXTRACTED/INFERRED-tillförlitlighet — inte bara en samling mätvärden. För PR/diff-påverkan: ange changed_paths och/eller patch (enhetlig diff); identifierar symboler per sökväg och returnerar kompakt information om inkommande beroende komponenter på begränsat djup utan att kräva ett symbolnamn. Efter en ändring anger du verify_after_edit=true med targets och/eller changed_paths för en kompakt ny fråga från flera rötter om påverkade symboler. Stöder även dependencies, centrality och orphans. analyze_dependencies använder samma traversering för påverkansanalys över flera steg.

Parametrar:

repository Valfri
Typ
str
Beskrivning
Repo som owner/repo[:branch]. Valfritt — utelämna för att använda klientens anropsspecifika standardrepo (om ett sådant anges) eller det enda tillgängliga repot; ange det uttryckligen bara för att välja ett annat indexerat repo. Exakt indexerade grenar prioriteras; en otillgänglig gren kan falla tillbaka till main eller den enda tillgängliga grenen. Svarets metadata visar den begärda och den faktiskt använda identiteten och varnar när detta sker.
query Valfri
Typ
str
Beskrivning
Symbolnamn eller sökterm
target Valfri
Typ
str
Beskrivning
Symbolnamn (alias för query)
symbol_id Valfri
Typ
UUID
Beskrivning
Välj med UUID en specifik förekomst bland kandidaterna för namnet i query/target, efter filtrering på namnrymd, sökväg och språk. Använd ett ID som returneras av find_symbol eller grafens alternativa resultat. Endast för traversering med angivet namn; ett ID utanför det begränsade kandidatfönstret ger ett fel.
changed_paths Valfri
Typ
list[str] maxItems=50
Beskrivning
Exakta filsökvägar relativt reporoten för PR/diff-påverkan (standard) eller, med verify_after_edit=true, startpunkter för verifiering efter ändring. Sökvägar som inte kan matchas kan returnera märkta förslag; föreslagna filer blir aldrig startpunkter för påverkan. PR/diff: utan radinformation går den igenom varje sökvägs toppnivådefinitioner (exporterade först, i filordning) och rapporterar changed_lines_unknown; skicka patch= för symboler som ändrats på radnivå. Verifiering: upp till 5 toppnivådefinitioner per sökväg som startpunkter (med en lägre gräns inne i verifieringsläget). Kräver inte query/target för PR/diff-påverkan.
patch Valfri
Typ
str maxLength=500000
Beskrivning
PR/diff-påverkan: text i formatet unified diff / git patch. Sökvägar hämtas från rubrikerna diff --git / --- / +++; rader i hunkar (gamla sidan = den indexerade committen) mappas till omslutande funktioner, metoder och klasser, som sedan följs för exakta beroenden, public_api_changed och de anropare som diffen inte rör.
head_commit Valfri
Typ
str pattern=^[0-9a-fA-F]{7,64}$
Beskrivning
Commit-SHA för koden du frågar om (git rev-parse HEAD, eller patchens bas-commit). complete:true kräver att indexet är på denna commit och byggt av den aktuella resolvern; annars blir det kvar som complete:false med index_stale / index_freshness_unverified / index_built_by_older_resolver, och index_basis.statement anger inom vilka gränser svaret är fullständigt. Raden 'base-commit:' i en patch (git format-patch --base) ger också värdet.
analysis_type Valfri
Typ
Literal[centrality, dependencies, dependents, impact, orphans]
Standard
dependencies
Beskrivning
Analysläge. impact = påverkansradie (inkommande beroenden; begränsat djup när depth utelämnas). dependents besvarar också frågor om påverkan. När changed_paths eller patch anges används alltid PR/diff-påverkansanalys. centrality/orphans kräver inget mål. orphans är kandidater för oanvänd kod, inte bevis för att den är säker att ta bort; verifiera referenserna i källkoden.
depth Valfri
Typ
Literal[shallow, balanced, deep]
Beskrivning
Traverseringsdjup. Standard är balanced; impact och PR/diff impact använder shallow som standard. Ett explicit angivet depth åsidosätter dessa standardvärden. Verifieringsläget använder alltid shallow.
limit Valfri
Typ
int minimum=1, maximum=50
Standard
20
Beskrivning
Max antal resultat per sida utan cursor. Fortsättning använder sidstorleken som lagras i cursor; utelämna cursor för att börja med en annan limit.
offset Valfri
Typ
int minimum=0
Beskrivning
Föråldrad kompatibilitets-offset. Föredra cursor från pagination.next_cursor.
cursor Valfri
Typ
str
Beskrivning
Ogenomskinlig cursor från pagination.next_cursor. Skicka den oförändrad och håll query och filter oförändrade. Dess position och sidstorlek har företräde framför offset och limit.
path_filter Valfri
Typ
str
Beskrivning
Begränsar upplösningen av målsymbolen till ett filsökvägsprefix; returnerade grafrelationer kan sträcka sig utanför den sökvägen
language_filter Valfri
Typ
str
Beskrivning
Filtrerar målupplösning och browse-resultat efter språk
direction Valfri
Typ
Literal[outgoing, incoming, both]
Beskrivning
Traverseringsriktning (åsidosätter analysis_type slutledning)
relationship_types Valfri
Typ
list[str]
Beskrivning
Filtrerar kanttyper (CALL, IMPORT, INHERITS_FROM med mera). En icke-tom lista åsidosätter graph_view-standardvärden.
exclude_test_paths Valfri
Typ
bool
Standard
true
Beskrivning
Standard true: exkluderar test-, fixture-, vendor- och exempelsökvägar från traverserings- och centralitetsresultat. Sätt false för att inkludera dem. Orphan-analysen följer detta bara där den driftsatta backenden stöder det; annars behåller den sina egna strängare brusexkluderingar och rapporterar justeringen.
exclude_generated_paths Valfri
Typ
bool
Standard
false
Beskrivning
Uteslut genererade deklarationer plus build, täckning, cache, källkarta och minifierade artefaktvägar från genomgångsresultat
include_module_symbols Valfri
Typ
bool
Standard
false
Beskrivning
Standard false: uteslut kanter vars from_name eller to_name är den syntetiska symbolen __module__ (brus på modulnivå). Ange true för att inkludera kanter på modulnivå i resultaten för dependents/dependencies.
include_isolated Valfri
Typ
bool
Beskrivning
Endast för orphans. Standard false. Ange true för att även returnera symboler utan rad i grafmåtten (inga grafkanter alls). Så länge exclude_test_paths är true förblir stilmalls-, markup- och datasymboler (CSS, HTML, ...), .d.ts-deklarationer och test/fixture/vendor/example-sökvägar exkluderade där backenden stöder det, om inte language_filter anger det språket; egenskaper i TypeScript-objektliteraler kan fortfarande visas som isolerade funktioner.
exclude_exported Valfri
Typ
bool
Standard
false
Beskrivning
Endast för föräldralösa symboler. Standard false: exporterade symboler (publikt API) som inte används i repot returneras med is_exported=true. Ange true för enbart interna kandidater.
branch Valfri
Typ
str
Beskrivning
Grenöverstyrning
per_hop_limit Valfri
Typ
int minimum=1, maximum=300
Beskrivning
Max antal relationer per hop (1-300)
include_metrics Valfri
Typ
bool
Standard
false
Beskrivning
Valfria grafmetriker på resultatrader (komprimerade med refactor_risk). Metriker hämtas även internt när min_centrality>0 men returneras bara om detta är true.
metrics_detail Valfri
Typ
Literal[summary, full]
Standard
summary
Beskrivning
När include_metrics=true: summary (standard) returnerar beslutssignaler + refactor_risk; full returnerar den större kurerade metriska uppsättningen
include_edge_metadata Valfri
Typ
bool
Standard
false
Beskrivning
Inkludera rå kantmetadata och vikter (stora datamängder). Detta är avstängt i kompakta svar om påverkan.
symbol_types Valfri
Typ
list[str]
Beskrivning
Filtrerar returnerade symboler efter typ (function, class, method osv.). Stöds inte i orphan-analys; använd i stället path_filter eller language_filter där. En tom lista tillämpar inget typfilter.
exact_match Valfri
Typ
bool
Standard
false
Beskrivning
Kräv exakt matchning av symbolnamn
find_similar_patterns Valfri
Typ
bool
Standard
false
Beskrivning
Hitta liknande användningsmönster
min_centrality Valfri
Typ
float minimum=0
Standard
0
Beskrivning
Lägsta PageRank-poäng för traversering av namngivna symboler och för PR-/diff-påverkan. Positiva tröskelvärden stöds inte i bläddringslägena centrality/orphans. Metriker hämtas internt för filtrering; graph_metrics returneras endast när include_metrics=true. Ignoreras av verify_after_edit, som använder fasta kompakta inställningar.
graph_view Valfri
Typ
Literal[dependency, type, data_flow, control_flow]
Standard
dependency
Beskrivning
Grafvy som används för traverseringsrelationers standardvärden, metriker och centralitetsrankning; orphan-analys beräknas över alla vyer
verify_after_edit Valfri
Typ
bool
Standard
false
Beskrivning
Frågar den indexerade impact-grafen igen för redigerade symboler i ett enda kompakt svar med flera rötter. Kräver targets och/eller changed_paths (eller target/query). Använder en fast shallow-traversering och kompakta budgetar; kontrollerna depth/limit/cursor/metrics gäller inte. Returnerar som standard incoming dependents; resultaten återspeglar den indexerade grafen (kan ligga efter liveredigeringar). När true har detta företräde framför PR/diff impact för samma changed_paths.
targets Valfri
Typ
list[str] maxItems=15
Beskrivning
När verify_after_edit=true: symbolnamn som ska verifieras igen (anropare/beroende komponenter). Slås samman med target/query om båda anges.

Bäst för:

  • Påverkansradie-/konsekvensanalys innan du redigerar en delad symbol
  • PR-/diff-påverkan via changed_paths eller patch
  • Verifiering efter redigering via verify_after_edit

Rekommenderas inte för:

  • Enkla text- eller symboluppslagningar — använd text_pattern_search eller find_symbol

Kodanalysverktyg

#

find_symbol Stabil

Hoppa till där en funktion, klass eller variabel definieras och används. Använd när du känner till namnet (t.ex. "getCurrentUser") — snabbare och mer exakt än Grep, och täcker hela det indexerade repot. Kan även returnera referenser och mätvärden för symbolens betydelse.

Parametrar:

symbol_name Valfri
Typ
str
Beskrivning
Symbolnamn att söka efter (valfritt – utelämna för att bläddra efter mätvärden)
repository Valfri
Typ
str
Beskrivning
Repo som owner/repo[:branch]. Valfritt — utelämna för att använda klientens anropsspecifika standardrepo (om ett sådant anges) eller det enda tillgängliga repot; ange det uttryckligen bara för att välja ett annat indexerat repo. Exakt indexerade grenar prioriteras; en otillgänglig gren kan falla tillbaka till main eller den enda tillgängliga grenen. Svarets metadata visar den begärda och den faktiskt använda identiteten och varnar när detta sker.
scope Valfri
Typ
Literal[definitions, references, both]
Standard
both
Beskrivning
Sökomfång; references kräver ett icke-tomt symbol_name.
limit Valfri
Typ
int minimum=1, maximum=50
Standard
15
Beskrivning
Max antal resultat per sida utan cursor. Fortsättning använder sidstorleken som lagras i cursor; utelämna cursor för att börja med en annan limit.
offset Valfri
Typ
int minimum=0
Beskrivning
Föråldrad kompatibilitets-offset. Föredra cursor från pagination.next_cursor.
cursor Valfri
Typ
str
Beskrivning
Ogenomskinlig cursor från pagination.next_cursor. Skicka den oförändrad och håll query och filter oförändrade. Dess position och sidstorlek har företräde framför offset och limit.
find_similar Valfri
Typ
bool
Standard
false
Beskrivning
Inkludera liknande symbolnamn
include_metrics Valfri
Typ
bool
Standard
false
Beskrivning
Inkludera centralitetsmått
metrics_detail Valfri
Typ
Literal[summary, full]
Standard
summary
Beskrivning
När include_metrics=true: summary (standard) returnerar beslutssignaler + refactor_risk; full returnerar den större kurerade metriska uppsättningen
path_filter Valfri
Typ
str
Beskrivning
Filtrera efter filsökvägsprefix
branch Valfri
Typ
str
Beskrivning
Grenöverstyrning
symbol_type Valfri
Typ
str minLength=1
Beskrivning
Filtrera efter indexerad symboltyp, t.ex. function, class, struct, enum eller trait. Använd typen som returneras av ett symbolresultat; typen varierar beroende på språk.
high_impact Valfri
Typ
bool
Standard
false
Beskrivning
Bläddra bland arkitektoniskt viktiga symboler (utelämna symbol_name). Standardläget är popularity (högsta PageRank-decilen minus utility-megahubbar). Sätt high_impact_mode=risk för artikulations-/bridge-skärningspunkter.
high_impact_mode Valfri
Typ
Literal[popularity, risk]
Standard
popularity
Beskrivning
När high_impact=true: popularity = den högsta PageRank-decilen utan stora hubbar/moduler för hjälpfunktioner; risk = artikulationspunkter rangordnade efter SMV bridge_count och därefter k_core (strukturell risk vid refaktorering, inte hubbarnas popularitet)
in_cycle Valfri
Typ
bool
Standard
false
Beskrivning
Filtrerar till symboler med registrerat medlemskap i en beroendecykel.
exclude_test_paths Valfri
Typ
bool
Standard
true
Beskrivning
När du bläddrar efter grafstatistik, uteslut tester, fixtures, tredjepartskod och exempel före rankning. Uppslag med en namngiven symbol är oförändrade.
reference_views Valfri
Typ
list[Literal[dependency, type, data_flow, control_flow, all]] minItems=1, maxItems=5
Beskrivning
Grafvyer vars inkommande kanter fyller references/reference_count (scope references/both). Standard ["dependency", "type"]: anrop, importer, exporter, referenser, instansieringar, arv, åsidosättningar, dekoratorer och typanvändning. Om data_flow inte väljs returneras exakt lösta data_flow-användningar (återanrop, hanterare, sorteringsnycklar) separat som value_references/value_reference_count, utan träffar som enbart härletts från namnet. Lägg till data_flow eller control_flow, eller skicka ["all"] för alla kanttyper och nivåer. Samma vyfamiljer som graph_view i dependency_search.
relationship_types Valfri
Typ
list[str]
Beskrivning
Uttryckliga typer av referenskanter (CALL, IMPORT, READS osv.). En icke-tom lista ersätter reference_views.

Bäst för:

  • Slå fast en känd symbols definition, referenser och grafmätvärden
  • Bläddra efter centrality, high_impact eller in_cycle när symbol_name utelämnas

Rekommenderas inte för:

  • Konceptuella frågor eller frågor inom ett okänt område — använd intelligent_search eller semantic_search

analyze_dependencies Stabil

Analysera påverkansradien med samma traversering som dependency_search (dependents/incoming). Använd helst dependency_search med analysis_type="dependents" eller "impact" för påverkansanalys. Returnerar ett påverkanssvar över flera steg med graph, connection_summary och valfria mätvärden med refactor_risk. connection_summary räknar för den valda roten de kanter som är avgränsade till relationsfamiljen, före all filtrering på tester eller sökvägar. De äldre fälten incoming_production/outgoing_production avser kanter utanför moduler, tester inräknade; de är inte antal produktionsanropare. Avgränsa relationsfamiljen med graph_view: dependency (standard), type, data_flow, control_flow.

Parametrar:

repository Valfri
Typ
str
Beskrivning
Repo som owner/repo[:branch]. Valfritt — utelämna för att använda klientens anropsspecifika standardrepo (om ett sådant anges) eller det enda tillgängliga repot; ange det uttryckligen bara för att välja ett annat indexerat repo. Exakt indexerade grenar prioriteras; en otillgänglig gren kan falla tillbaka till main eller den enda tillgängliga grenen. Svarets metadata visar den begärda och den faktiskt använda identiteten och varnar när detta sker.
target Obligatorisk
Typ
str minLength=1
Beskrivning
Symbolnamn att analysera
symbol_id Valfri
Typ
UUID
Beskrivning
Välj med UUID en specifik förekomst bland target-kandidaterna, efter filtrering på namnrymd, sökväg och språk; ID:n utanför det begränsade kandidatfönstret ger ett fel.
depth Valfri
Typ
Literal[shallow, balanced, deep]
Standard
balanced
Beskrivning
Analysdjup
limit Valfri
Typ
int minimum=1, maximum=50
Standard
10
Beskrivning
Max antal resultat per sida utan cursor. Fortsättning använder sidstorleken som lagras i cursor; utelämna cursor för att börja med en annan limit.
offset Valfri
Typ
int minimum=0
Beskrivning
Föråldrad kompatibilitets-offset. Föredra cursor från pagination.next_cursor.
cursor Valfri
Typ
str
Beskrivning
Ogenomskinlig cursor från pagination.next_cursor. Skicka den oförändrad och håll query och filter oförändrade. Dess position och sidstorlek har företräde framför offset och limit.
direction Valfri
Typ
Literal[incoming, outgoing, both]
Standard
incoming
Beskrivning
Traverseringsriktning
relationship_types Valfri
Typ
list[str]
Beskrivning
Filtrerar kanttyper (CALL, IMPORT, INHERITS_FROM osv.). En icke-tom lista åsidosätter graph_view-standardvärdena; en tom lista använder dessa standardvärden.
graph_view Valfri
Typ
Literal[dependency, type, data_flow, control_flow]
Standard
dependency
Beskrivning
Grafvy: avgör både vilka kanttyper som traverseras som standard och från vilken vy metrics används när include_metrics=true. dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (standard), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]. Tillämpas som standardvärde för relationship_types när relationship_types utelämnas eller är tomt. Matchar det befintliga graph_view-parameternamnet i dependency_search, för konsekvens mellan verktygen.
path_filter Valfri
Typ
str
Beskrivning
Begränsar upplösningen av målsymbolen till ett filsökvägsprefix; returnerade grafrelationer kan sträcka sig utanför den sökvägen
language_filter Valfri
Typ
str
Beskrivning
Språkfilter
branch Valfri
Typ
str
Beskrivning
Grenöverstyrning
per_hop_limit Valfri
Typ
int minimum=1, maximum=300
Beskrivning
Max antal relationer per hop (1-300)
include_metrics Valfri
Typ
bool
Standard
false
Beskrivning
Inkludera grafstatistik i resultaten, var och en berikad med ett härlett refactor_risk-block ({risk: "low"|"medium"|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}). risken är "low" när den inte är en artikulationspunkt (i den valda vyn), "medium" när en artikulationspunkt överbryggar få kanter, "high" när den överbryggar många (heuristisk tröskel, ej empiriskt validerad). Utelämnad per symbol när det inte finns någon mätvärdesrad för den symbolen/vyn.
metrics_detail Valfri
Typ
Literal[summary, full]
Standard
summary
Beskrivning
När include_metrics=true: summary (standard) returnerar beslutssignaler + refactor_risk; full returnerar den större kurerade metriska uppsättningen
include_edge_metadata Valfri
Typ
bool
Standard
false
Beskrivning
Inkludera rå kantmetadata och vikter. Inaktiverad som standard eftersom extraheringsmetadata kan vara stora; anrikningstäckning rapporteras när den är aktiverad.
exclude_test_paths Valfri
Typ
bool
Standard
true
Beskrivning
Standard true: exkludera test-, fixtur-, leverantörs- och exempelsökvägar från returnerade grafkanter. Ställ in false för att inkludera dem.
include_module_symbols Valfri
Typ
bool
Standard
false
Beskrivning
Som standard utesluter false grafkanter när from_name eller to_name är den syntetiska __module__-symbolen. Ställ in true för att inkludera kanter på modulnivå.
head_commit Valfri
Typ
str pattern=^[0-9a-fA-F]{7,64}$
Beskrivning
Commit-SHA för koden du frågar om (git rev-parse HEAD, eller patchens bas-commit). complete:true kräver att indexet är på denna commit och byggt av den aktuella resolvern; annars blir det kvar som complete:false med index_stale / index_freshness_unverified / index_built_by_older_resolver, och index_basis.statement anger inom vilka gränser svaret är fullständigt. Raden 'base-commit:' i en patch (git format-patch --base) ger också värdet.

Bäst för:

  • Påverkansanalys över flera steg när du behöver svarsfälten graph och connection_summary

Rekommenderas inte för:

  • Allmän påverkansanalys: använd helst dependency_search för flexibel traversering och kontroller från flera rötter

get_task_context Stabil

Ska du börja arbeta i ett obekant område? Beskriv uppgiften (t.ex. "lägg till SSO-stöd", "fixa faktureringswebhooken") och få, i ett enda anrop, ett avgränsat paket med relevanta filer, kod, symboler och beroenden. Filer som anges som seed bidrar med direkt indexerat innehåll även om de inte definierar några symboler. Misslyckade lager märks; ett totalt misslyckat hämtningsförsök returnerar ett verktygsfel. För fler resultat, fortsätt med det specialiserade sökverktyget för det lagret.

Parametrar:

task_description Obligatorisk
Typ
str minLength=1
Beskrivning
Beskrivning av uppgiften du behöver sammanhang för
repository Valfri
Typ
str
Beskrivning
Repo som owner/repo[:branch]. Valfritt — utelämna för att använda klientens anropsspecifika standardrepo (om ett sådant anges) eller det enda tillgängliga repot; ange det uttryckligen bara för att välja ett annat indexerat repo. Exakt indexerade grenar prioriteras; en otillgänglig gren kan falla tillbaka till main eller den enda tillgängliga grenen. Svarets metadata visar den begärda och den faktiskt använda identiteten och varnar när detta sker.
limit Valfri
Typ
int minimum=1, maximum=50
Standard
15
Beskrivning
Maximalt antal resultat per lager
scope Valfri
Typ
Literal[semantic, symbols, dependencies, all]
Standard
all
Beskrivning
Vilka kontextlager som ska inkluderas
language_filter Valfri
Typ
str
Beskrivning
Språkfilter: kräver scope=semantic utan uttryckliga startpunkter eller relaterad kontext; index i andra lager kan inte genomdriva språkbegränsningen.
path_filter Valfri
Typ
str
Beskrivning
Filsökvägsprefix för semantiska och nyckelordsbaserade hämtningsstartpunkter. Explicita seeds kan ligga utanför detta prefix; grafkontexten kan korsa katagränser.
branch Valfri
Typ
str
Beskrivning
Grenöverstyrning
include_related_context Valfri
Typ
bool
Standard
false
Beskrivning
Inkludera relaterad kontext från intilliggande symboler
seed_symbol_ids Valfri
Typ
list[str] maxItems=20
Beskrivning
Explicita uppgiftsstartpunkter: visas först i symbollagret och behålls inom det begränsade dependencies/related_context-fönstret. Graflagren rangordnar explicita startpunkter och deras närmaste omgivning före återfallet till nyckelord; betydelsen avgör bara vid lika relevans. Grafexpansion kräver scope=all|dependencies (scope=symbols|semantic kör aldrig beroendetraverseringen). Utelämna för en rangordning enbart på nyckelord med djupavtagande betydelse.
seed_file_paths Valfri
Typ
list[str] maxItems=10
Beskrivning
Explicita seeds: exakta indexerade filsökvägar som agenten har öppna eller just har redigerat. Returnerar begränsade direkta filbevis och upp till 5 grafseeds per fil, där exakta träffar på uppgiftsnamnet från en begränsad symboluppslagning går före definitioner och tillfälliga symboler. Filer utan symboler ger fortfarande bevis. Saknade filer kan returnera märkta förslag som inte är seeds. Grafexpansion kräver scope=all|dependencies.

Bäst för:

  • Uppgiftsmedveten kontext som blandar seed-filer med semantiska, symbol- och beroendelager

Rekommenderas inte för:

  • Uppslagningar med ett enda verktyg där ett mer specifikt verktyg redan besvarar frågan

get_file Stabil

Läser en fil från det indexerade repot via sökväg. Föredra lokala filverktyg för filer på disk; använd detta för fjärrindexerade ögonblicksbilder. Fortsätt begränsade svar med metadata.next_line_start och next_character_start. Ta endast bort den avslutande radbrytningen plus [truncated]-markören när metadata.truncated=true; annars kan det vara bokstavlig källtext.

Parametrar:

file_path Obligatorisk
Typ
str
Beskrivning
Filsökväg i förhållande till arkivroten
repository Valfri
Typ
str
Beskrivning
Repo som owner/repo[:branch]. Valfritt — utelämna för att använda klientens anropsspecifika standardrepo (om ett sådant anges) eller det enda tillgängliga repot; ange det uttryckligen bara för att välja ett annat indexerat repo. Exakt indexerade grenar prioriteras; en otillgänglig gren kan falla tillbaka till main eller den enda tillgängliga grenen. Svarets metadata visar den begärda och den faktiskt använda identiteten och varnar när detta sker.
line_start Valfri
Typ
int minimum=1
Beskrivning
Startrad (1-indexerad)
line_end Valfri
Typ
int minimum=1
Beskrivning
Slutrad (1-indexerad, inklusive; måste vara vid eller efter line_start)
character_start Valfri
Typ
int minimum=0
Standard
0
Beskrivning
Förskjutning i UTF-16-kodenheter endast inom startraden (0-indexerad). Använd metadata.next_character_start för att fortsätta en delvis läst rad.
branch Valfri
Typ
str
Beskrivning
Grenöverstyrning
max_tokens Valfri
Typ
int minimum=1, maximum=50000
Standard
5000
Beskrivning
Ungefärlig innehållsbudget (4 UTF-16-kodenheter per token; ingen exakt tokenizergräns).
include_metadata Valfri
Typ
bool
Standard
true
Beskrivning
Inkludera beskrivande filmetadata. Metadata för avkortning och fortsättning returneras alltid.

Bäst för:

  • Fjärr- eller indexerade filsnapshots (radintervall, tokengränser)

Rekommenderas inte för:

  • En sökväg som redan finns på lokal disk — använd det lokala Read-verktyget

System- och hjälpverktyg

#

repository_context Stabil

Listar de repositories du kan söka i, eller hämtar identitetsinformation om ett av dem (namespace/branch, indexed_commit_sha / indexets aktualitet). Använd action:"list" när repository-sluggen är okänd; sökverktygen accepterar en känd slugg direkt eller använder som standard din nyckels enda repository. list använder pattern och paginering; info kräver repository och stöder branch samt valfritt include_statistics=true.

Parametrar:

action Obligatorisk
Typ
Literal[list, info]
Beskrivning
Åtgärd: lista tillgängliga repo med list eller hämta repoinformation med info
repository Valfri
Typ
str
Beskrivning
Endast för info: repository i formatet owner/repo eller owner/repo:branch (krävs för info)
branch Valfri
Typ
str
Beskrivning
Endast för info: grenöverstyrning
pattern Valfri
Typ
str
Beskrivning
Endast för list: delsträng av repository-namnet, skiftlägesokänslig
include_statistics Valfri
Typ
bool
Standard
false
Beskrivning
Endast information: inkluderar begränsade indexdataräkningar. file/blob-räkningar är exakta; större indexräkningar är uppskattningar. Se count_accuracy och estimate_analyzed_at. Standard false.
limit Valfri
Typ
int minimum=1, maximum=50
Standard
20
Beskrivning
Max antal resultat per sida utan cursor. Fortsättning använder sidstorleken som lagras i cursor; utelämna cursor för att börja med en annan limit.
offset Valfri
Typ
int minimum=0
Beskrivning
Utfasad kompatibilitetsförskjutning. Använd helst cursor från pagination.next_cursor.
cursor Valfri
Typ
str
Beskrivning
Ogenomskinlig cursor från pagination.next_cursor. Skicka den oförändrad och håll query och filter oförändrade. Dess position och sidstorlek har företräde framför offset och limit.

Bäst för:

  • Lista tillgängliga repon
  • Fastställa repo-identitet, branch och HEAD-kontra-index-aktualitet

Rekommenderas inte för:

  • Namespace-omfattande statistik som standard — skicka include_statistics=true explicit, eftersom det kan vara långsammare än upplösning

ask_maguyva Stabil

Få vägledning om Maguyva-verktyg eller skicka en felrapport eller ett funktionsönskemål som sparas för de som underhåller Maguyva. Ta aldrig med hemligheter eller känsliga personuppgifter i återkopplingen. Operationen evaluate stöder deterministiska uttryck; använd helst lokal beräkning eller värdmiljöns verktyg för matematik, hashvärden och strängar.

Parametrar:

operation Obligatorisk
Typ
Literal[guidance, report_bug, request_feature, evaluate]
Beskrivning
Använd guidance för verktygshjälp, report_bug för fel eller request_feature för förslag. evaluate kör deterministiska uttryck; använd helst lokal beräkning för uträkningar.
query Valfri
Typ
str maxLength=500
Beskrivning
Vägledningsämne (till exempel tool_selection, semantic_search) eller en uttryckssträng för evaluate.
description Valfri
Typ
str minLength=1, maxLength=4000
Beskrivning
Krävs för report_bug och request_feature. Återkoppling i fritext till dem som underhåller Maguyva. Inkludera aldrig hemligheter eller känsliga personuppgifter.
related_tool Valfri
Typ
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]
Beskrivning
Valfritt Maguyva-verktyg som är närmast relaterat till feedbacken

Bäst för:

  • Verktygsvägledning (operation="guidance")
  • Beständiga felrapporter och funktionsförfrågningar för underhållarna av Maguyva

Rekommenderas inte för:

  • Beräkningar med matematik, hashvärden eller strängar: använd helst lokal beräkning eller värdmiljöns verktyg

Bästa praxis

#
  1. Använd explicita åsidosättanden medvetet: Utelämna repot när MCP-klienten anger ett anropsspecifikt standardrepo eller när nyckeln har åtkomst till exakt ett repo; ange det annars uttryckligen.
  2. Välj rätt sökläge: Använd intelligent_search med mode="auto" i de flesta fall. Ange ett läge när du vet exakt vad du behöver.
  3. Utnyttja språkfilter: Använd language_filter för att begränsa resultat och förbättra prestanda.
  4. GraphRAG Boosting: GraphRAG-viktökning är avstängd som standard för semantisk sökning (boost_by_importance=false) för att hålla rankningen agentsäker. Skicka boost_by_importance=true för att aktivera centralitetsmedveten omrankning för arkitekturgenomgångar.
  5. Repomatchning ignorerar skiftläge men gör ingen fuzzy-matchning: repository_context matchar repositoriumnamn skiftlägesokänsligt — men rättar inte stavfel. När den identitet som levereras skiljer sig från den begärda rapporterar metadata.resolution_reason "defaulted" (ingen gren begärdes) eller "fallback" (den begärda grenen eller repositoriet är inte tillgängligt). Fältet utelämnas när begäran stämde exakt.
  6. Kombinera verktyg: Använd flera API-metoder tillsammans för omfattande analys.
  7. Hantera stora resultat: Använd limit och verktygsspecifika pagineringskontroller (till exempel line_start/line_end i get_file).
  8. Använd ask_maguyva för verktygsvägledning: Anropa ask_maguyva med operation="guidance" och query="tool_selection" för råd om verktygsval och exempel. Använd lokala verktyg för beräkningar och strängomvandlingar.
  9. Verifiera påverkan före och efter redigering: Anropa dependency_search med analysis_type="impact" innan du ändrar en delad symbol (eller skicka changed_paths för PR/diff-påverkan) för att se påverkansradien. Efter ändringen anger du verify_after_edit=true med targets och/eller changed_paths för en kompakt omkontroll av den indexerade grafen. Detta läser inte lokala ändringar utan commit och ersätter inte lokala tester. Kontrollera indexed_commit_sha och indexets aktualitet innan du använder resultaten som underlag för en ny revision.

Prestandaegenskaper

#
Åtgärd Prestandaanteckningar
Semantisk sökning Omfattar generering av frågans vektorrepresentation och vektorhämtning. Svarstiden beror på båda operationerna.
Textsökning Vid ungefärlig innehållssökning hämtar senare sidor fler kandidater. Avgränsa frågan med path_filter och language_filter.
Strukturell sökning Söker i indexerade AST-noder. Använd en specifik förinställning eller ett mönster och begränsa antalet resultat.
Beroendesökning Kostnaden skalar med djupet — föredra depth="shallow" om du inte behöver kontext med flera hopp; per_hop_limit begränsar spridningen
Filhämtning Läs det intervall du behöver med line_start/line_end eller max_tokens och använd returnerad fortsättningsmetadata för avkortat innehåll.
Repository-kontext Kodarkivet identifieras för varje verktygsanrop. Ange repository uttryckligen när du behöver ett specifikt kodarkiv.
ask_maguyva (guidance / evaluate) Körs i MCP-servern utan att söka i kodarkivets index.

Felhantering

#

Verktygssvar innehåller gemensamma statusfält och verktygsspecifika datafält på toppnivån. Sökningar returnerar results; get_file returnerar content. Gemensamma fält är:

  • status: Sträng — "success" eller "error". Signaler om försvagad matchning och färskhet har egna fält: metadata.resolution_reason under metadata, och index_freshness.status på toppnivå i repository_context info-åtgärden.
  • timing_ms: Verktygets förflutna körningstid i millisekunder
  • applied_filters: De effektiva begärandeparametrar som registrerats för operationen
  • error: Felmeddelande som sträng när status är "error"; kan innehålla återställningsråd.
  • metadata: Ytterligare information om operationen (routning, cachning, parameterjusteringar)
  • pagination: Finns i svar med markörpaginerade samlingar; omfattar has_more och next_cursor. Rangordnade sökfönster är avgränsade top-K-resultat, inte uttömmande paginerade samlingar.

Kontrollera fältet status innan du bearbetar ett verktygs payload — värdena är "success" eller "error". Hantera även MCP/JSON-RPC-transportfel och fel vid begäranvalidering, som kan uppstå innan någon payload alls skapats. För signaler om försvagad matchning eller färskhet läser du i stället det avsedda fältet: metadata.resolution_reason under metadata, eller index_freshness.status på toppnivå i repository_context info-åtgärden (known/partial/unknown/unavailable).

Kom igång

#
  1. Konfigurera MCP-klienten: Rikta MCP-klienten till Maguyva-serverns slutpunkt
  2. Bekräfta repoåtkomst: Använd repository_context med "list" eller "info" för att granska repon som API-nyckeln har åtkomst till
  3. Börja söka: Börja med intelligent_search och utforska specialiserade verktyg efter behov
  4. Kombinera verktyg: Använd flera verktyg tillsammans för en heltäckande kodanalys

För detaljerade integrationsinstruktioner, se installationsguide.

Relaterat

Läs vidare