MCP API-reference

Udforsk de 11 MCP-værktøjer i Maguyva, deres parametre, og hvornår de skal bruges. Kontrollér tools/list-svaret fra din tilsluttede klient for de tilgængelige argumenter.

Værktøjerne er organiseret i 4 kategorier:

• 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 - Repositoriekontekst, værktøjsvejledning og tilbagemeldinger

For værktøjer, der accepterer et repositorium, skal du bruge dette repository-identifikatorformat: "owner/repo:branch". Grenen er som standard main, hvis den ikke angives.

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.

Brug disse formater, når du angiver et repositorium:

• 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"

Brug language_filter i søgetilstande, der understøtter det. Vælg search_scope="content" for text_pattern_search; brug scope="semantic" uden startpunkter eller relateret kontekst for get_task_context.

• 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 alle 285+ 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 21. oktober 2026.

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 depotnavne uden hensyn til store og små bogstaver — men retter ikke stavefejl. Når den identitet, der leveres, afviger fra den, der blev bedt om, melder metadata.resolution_reason "defaulted" (der blev ikke bedt om en gren) eller "fallback" (den ønskede gren eller det ønskede depot er utilgængeligt). Feltet udelades, når anmodningen ramte præcist.
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: Kald ask_maguyva med operation="guidance" og query="tool_selection" for råd om værktøjsvalg og eksempler. Brug lokale værktøjer til beregninger og strengtransformationer.
9. Verificer konsekvenser før og efter redigering: Før du ændrer et delt symbol, skal du kalde dependency_search med analysis_type="impact" (eller sende changed_paths for PR/diff-påvirkning) for at se blast radius. Efter ændringen angiver du verify_after_edit=true med targets og/eller changed_paths for en kompakt genkontrol af den indekserede graf. Dette læser ikke lokale ændringer uden commit og erstatter ikke lokale tests. Kontrollér indexed_commit_sha og indeksets aktualitet, før du bruger resultaterne som belæg for en ny revision.

Værktøjssvar indeholder fælles statusfelter og værktøjsspecifikke datafelter på øverste niveau. Søgninger returnerer results; get_file returnerer content. Fælles felter omfatter:

• status: Streng — "success" eller "error". Signaler om svækket match og indeksfriskhed har deres egne felter: metadata.resolution_reason under metadata og index_freshness.status på øverste niveau i repository_context's info-handling.
• timing_ms: Værktøjets forløbne udførelsestid i millisekunder
• applied_filters: Faktiske forespørgselsparametre registreret for operationen
• error: Fejlmeddelelse som streng, når status er "error"; kan indeholde råd om genopretning.
• metadata: Yderligere information om operationen (routing, caching, parameterjusteringer)
• pagination: Findes i svar med markørpaginerede samlinger; omfatter has_more og next_cursor. Rangordnede søgevinduer er afgrænsede top-K-resultater, ikke udtømmende paginerede samlinger.

Tjek feltet status, før du behandler et værktøjs payload — værdierne er "success" eller "error". Håndtér også MCP/JSON-RPC-transportfejl og fejl i anmodningsvalidering, som kan opstå, før der overhovedet findes en payload. For signaler om svækket match eller friskhed skal du i stedet læse det dedikerede felt: metadata.resolution_reason under metadata eller index_freshness.status på øverste niveau i repository_context's info-handling (known/partial/unknown/unavailable).

1. Konfigurér MCP-klienten: Peg din MCP-klient mod Maguyva-serverens endpoint
2. Bekræft adgang til repoet: Brug repository_context med list eller info til at undersøge de repos, API-nøglen har adgang til
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.