MCP API-reference

Komplet reference for alle 11 kundevendte Maguyva MCP-værktøjer. Hvert værktøj indeholder parametre, brugsvejledning og anbefalinger til, hvad det er bedst til.

API-overblik#

Maguyva MCP API'et eksponerer i øjeblikket 11 kundevendte værktøjer fordelt på 4 hovedkategorier:

• Kernesøgeværktøjer - Avancerede søgemuligheder på tværs af din kodebase
• Strukturelle værktøjer & grafværktøjer - AST-forespørgsler, symbolopslag og afhængighedsanalyse
• Kodeanalyseværktøjer - Dyb kodeanalyse og relationskortlægning
• System- og hjælpeværktøjer - Repository-kontekst, deterministisk beregning og vejledning

Alle værktøjer bruger et konsistent repository-identifikatorformat: "owner/repo:branch". Branch er som standard main, hvis ikke angivet.

Udelad repository, når MCP-klienten angiver en standard for den aktuelle forespørgsel, eller når nøglen har adgang til præcis ét repo; angiv den ellers eksplicit. Brug repository_context(action="info", repository="owner/repo") til at se, hvordan et repo matches.

Format for repository-parameter#

Alle MCP-værktøjer bruger dette repository-identifikatorformat:

• Med branch: "owner/repo:branch" - f.eks., "owner/repository:develop"
• Standardbranch: "owner/repo" - bruger main-branchen, når ingen branch er angivet "owner/repository"
• Standard for forespørgsel eller eneste repo: Udelad repoet, når MCP-klienten angiver en standard for den aktuelle forespørgsel, eller når nøglen har adgang til præcis ét repo; angiv det ellers eksplicit

Eksempler på prompts:

Spørg om et bestemt repo:        "Søg owner/my-repo efter authentication middleware"
Vis tilgængelige repoer:         "Hvilke repoer har denne Maguyva-nøgle adgang til?"
Tilsidesæt for én forespørgsel:  "Søg owner/other-repo:develop efter godkendelsesmønstre"

Sprogfiltrering#

Alle søgeværktøjer understøtter filtrering af resultater efter programmeringssprog:

• language_filter="python" - Filtrer til kun Python-filer
• language_filter="typescript" - Filtrer til kun TypeScript-filer
• Versalfølsom: Brug små bogstaver til sprognavne
• Standard: Tom streng (ingen filtrering) - returnerer resultater fra alle sprog
• Understøttet dækning: Sprogfiltre fungerer på tværs af den fulde 279+ understøttede sprog og tekstbaserede teknologier. Se kompatibilitet for den fulde liste.

"Find authentication middleware kun i Python-filer"
"Søg efter databaseforbindelser i TypeScript"

API-reference genereret fra kilden den 22. juli 2026.

Bedste praksis#

1. Brug eksplicitte tilsidesættelser bevidst: Udelad repoet, når MCP-klienten angiver en standard for den aktuelle forespørgsel, eller når nøglen har adgang til præcis ét repo; angiv det ellers eksplicit.
2. Vælg den rigtige søgetilstand: Brug intelligent_search med mode="auto" i de fleste tilfælde. Angiv en tilstand, når du ved præcis, hvad du har brug for.
3. Udnyt sprogfiltre: Brug language_filter til at indsnævre resultater og forbedre ydeevnen.
4. GraphRAG Boosting: GraphRAG-vigtighedsboosting er slået fra som standard for semantisk søgning (boost_by_importance=false) for at holde rangeringen agent-sikker. Send boost_by_importance=true for at aktivere centralitetsbevidst omrangering til arkitekturgennemgange.
5. Repository-matchning skelner ikke mellem store/små bogstaver, men er ikke fuzzy: repository_context matcher repository-navne uafhængigt af store/små bogstaver — den retter ikke stavefejl. Tjek metadata.resolution_reason på info-handlingen ("exact" versus "corrected") for at se, hvordan et navn blev matchet.
6. Kombiner værktøjer: Brug flere API-metoder sammen til en omfattende analyse.
7. Håndter store resultater: Brug limit og værktøjsspecifikke pagineringskontroller (for eksempel line_start/line_end i get_file).
8. Brug ask_maguyva til værktøjsvejledning: ask_maguyvas evaluate-handling (hash, base64, JSON, matematik) er kun legacy / bagudkompatibilitet. Kald i stedet ask_maguyva med operation="guidance" og query="tool_selection" for local-tool-wins-matrixen og et komplet værktøj-for-værktøj snydeark.
9. Verificer konsekvenser før og efter redigering: Før du redigerer et delt symbol, skal du kalde dependency_search med analysis_type="impact" (eller sende changed_paths for PR-/diff-konsekvens) for at se dets konsekvensradius. Efter redigering skal du sætte verify_after_edit=true med targets og/eller changed_paths for et kompakt genkontrol af de samme symboler.

Ydeevneegenskaber#

Fejlhåndtering#

Alle API-metoder returnerer en struktureret konvolut:

• status: Streng — "success" eller "error". Signaler om forringet match eller friskhed findes i indlejrede felter som metadata.resolution_reason på repository_context eller metadata.index_freshness.status.
• tool: Navnet på det værktøj, der genererede svaret
• data: Resultatpayload ved succes (struktur varierer efter værktøj)
• error: Struktureret fejlobjekt, når status er "error" — inkluderer type, message, suggestions og recovery_actions
• metadata: Yderligere information om operationen (routing, caching, parameterjusteringer)
• pagination: Findes på listesvar — inkluderer has_more og next_cursor

Tjek altid feltet status, før du behandler resultater — det er kun enten "success" eller "error". For signaler om forringet match eller friskhed skal du i stedet læse det indlejrede felt: metadata.resolution_reason på repository_context, eller metadata.index_freshness.status (known/partial/unknown/unavailable).

Kom i gang#

1. Konfigurer MCP Client: Ret din MCP-klient til Maguyva-serverens slutpunkt
2. Bekræft lageradgang: Brug repository_context med liste eller info til at inspicere lagre, der er tilgængelige for API-nøglen
3. Begynd at søge: Begynd med intelligent_search og udforsk specialiserede værktøjer efter behov
4. Kombiner værktøjer: Brug flere værktøjer sammen til omfattende kodeanalyse

Se installationsguide for detaljerede integrationsinstruktioner.