MCP API-referanse

Utforsk de 11 MCP-verktøyene i Maguyva, parameterne deres og når hvert verktøy bør brukes. Sjekk tools/list-svaret fra den tilkoblede klienten for tilgjengelige argumenter.

Verktøyene er organisert i 4 kategorier:

• Kjernesøkeverktøy - Avanserte søkefunksjoner på tvers av kodebasen din
• Strukturelle og grafverktøy - AST-spørringer, symboloppslag og avhengighetsanalyse
• Kodeanalyseverktøy - Dyp kodeanalyse og kartlegging av sammenhenger
• System- og hjelpeverktøy - Repositoriekontekst, verktøyveiledning og tilbakemeldinger

For verktøy som godtar et repositorium, bruk følgende format for repo-identifikator: "owner/repo:branch". Grenen er main hvis ikke annet er angitt.

Utelat repository når MCP-klienten oppgir en standard for den aktuelle forespørselen, eller når nøkkelen har tilgang til nøyaktig ett repo; ellers oppgir du den eksplisitt. Bruk repository_context(action="info", repository="owner/repo") for å se hvordan et repo identifiseres.

Bruk disse formatene når du angir et repositorium:

• Med gren: "owner/repo:branch" - f.eks. "owner/repository:develop"
• Standard gren: "owner/repo" - bruker main når ingen gren er angitt "owner/repository"
• Standard for forespørsel eller eneste repo: Utelat repoet når MCP-klienten oppgir en standard for den aktuelle forespørselen, eller når nøkkelen har tilgang til nøyaktig ett repo; ellers oppgir du det eksplisitt

Eksempler på ledetekster:

Spør om et bestemt repo:    "Søk owner/my-repo etter autentiseringsmellomvare"
List tilgjengelige repoer:  "Hvilke repoer har denne Maguyva-nøkkelen tilgang til?"
Overstyr for ett søk:       "Søk i owner/other-repo:develop etter autentiseringsmønstre"

Bruk language_filter i søkemoduser som støtter det. Velg search_scope="content" for text_pattern_search; bruk scope="semantic" uten startpunkter eller relatert kontekst for get_task_context.

• language_filter="python" - Filtrer til kun Python-filer
• language_filter="typescript" - Filtrer til kun TypeScript-filer
• Skiller mellom store/små bokstaver: Bruk språknavn med små bokstaver
• Standard: Tom streng (ingen filtrering) - returnerer resultater fra alle språk
• Støttet dekning: Språkfiltre fungerer på tvers av alle 285+ støttede språk og tekstbaserte teknologier. Se kompatibilitet for den fullstendige listen.

"Finn autentiseringsmiddleware kun i Python-filer"
"Søk etter databasetilkoblinger i TypeScript"

API-referanse generert fra kildekode 21. oktober 2026.

1. Bruk eksplisitte overstyringer bevisst: Utelat repoet når MCP-klienten oppgir en standard for den aktuelle forespørselen, eller når nøkkelen har tilgang til nøyaktig ett repo; ellers oppgir du det eksplisitt.
2. Velg riktig søkemodus: Bruk intelligent_search med mode="auto" i de fleste tilfeller. Angi en modus når du vet nøyaktig hva du trenger.
3. Utnytt språkfiltre: Bruk language_filter for å begrense resultater og forbedre ytelsen.
4. GraphRAG-forsterkning: GraphRAG-viktighetsforsterkning er avslått som standard for semantisk søk (boost_by_importance=false) for å holde rangeringen agent-sikker. Send boost_by_importance=true for å aktivere sentralitetsbevisst omrangering for arkitekturgjennomganger.
5. Repooppslag skiller ikke mellom store og små bokstaver, men gir ikke tilnærmede treff: repository_context matcher depotnavn uten å skille mellom store og små bokstaver — men retter ikke skrivefeil. Når identiteten som leveres avviker fra den som ble bedt om, melder metadata.resolution_reason "defaulted" (ingen gren ble etterspurt) eller "fallback" (den etterspurte grenen eller depotet er utilgjengelig). Feltet utelates når forespørselen traff nøyaktig.
6. Kombiner verktøy: Bruk flere API-metoder sammen for omfattende analyse.
7. Håndter store resultater: Bruk limit og verktøyspesifikke pagineringskontroller (for eksempel line_start/line_end i get_file).
8. Bruk ask_maguyva for verktøyveiledning: Kall ask_maguyva med operation="guidance" og query="tool_selection" for råd om verktøyvalg og eksempler. Bruk lokale verktøy for beregninger og strengtransformasjoner.
9. Verifiser konsekvenser før og etter redigering: Før du endrer et delt symbol, kall dependency_search med analysis_type="impact" (eller send changed_paths for PR/diff-påvirkning) for å se påvirkningsradiusen. Etter endringen setter du verify_after_edit=true med targets og/eller changed_paths for en kompakt ny kontroll av den indekserte grafen. Dette leser ikke lokale endringer uten commit og erstatter ikke lokale tester. Kontroller indexed_commit_sha og hvor oppdatert indeksen er før du bruker resultatene som underlag for en ny revisjon.

Verktøysvar inneholder felles statusfelt og verktøyspesifikke datafelt på toppnivå. Søk returnerer results; get_file returnerer content. Felles felt inkluderer:

• status: Streng — "success" eller "error". Signaler om svekket treff og indeksferskhet har egne felt: metadata.resolution_reason under metadata, og index_freshness.status på øverste nivå i info-handlingen til repository_context.
• timing_ms: Medgått kjøretid for verktøyet i millisekunder
• applied_filters: Faktiske forespørselsparametere registrert for operasjonen
• error: Feilmelding som streng når status er "error"; kan inneholde gjenopprettingsråd.
• metadata: Tilleggsinformasjon om operasjonen (ruting, caching, parameterjusteringer)
• pagination: Finnes i svar med markørpaginerte samlinger; inkluderer has_more og next_cursor. Rangerte søkevindu er avgrensede top-K-resultater, ikke uttømmende paginerte samlinger.

Sjekk feltet status før du behandler et verktøys payload — verdiene er "success" eller "error". Håndter også MCP/JSON-RPC-transportfeil og feil i forespørselsvalidering, som kan oppstå før noen payload i det hele tatt finnes. For signaler om svekket treff eller ferskhet leser du i stedet det dedikerte feltet: metadata.resolution_reason under metadata, eller index_freshness.status på øverste nivå i info-handlingen til repository_context (known/partial/unknown/unavailable).

1. Konfigurer MCP-klienten: Pek MCP-klienten mot endepunktet til Maguyva-serveren
2. Bekreft tilgang til repoer: Bruk repository_context med "list" eller "info" for å undersøke repoene API-nøkkelen har tilgang til
3. Begynn å søke: Begynn med intelligent_search og utforsk spesialiserte verktøy etter behov
4. Kombiner verktøy: Bruk flere verktøy sammen for en omfattende kodeanalyse

For detaljerte integrasjonsinstruksjoner, se installasjonsguide.