Lumaktaw papunta sa content

Mga Resipe

Mga praktikal na recipe para sa pang-araw-araw na gawaing Maguyva MCP. Ang bawat recipe ay pinangalanan ang mga tool at ang pagkakasunud-sunod - hindi isang buong sanggunian ng parameter. Para sa mga parameter ng tool, gamitin ang MCP API Sanggunian. Para sa unang beses na pag-setup, gamitin ang Quickstart.

Piliin ang tamang tool#

Karamihan sa mga tanong ay nagsisimula sa isang tawag. I-escalate lamang kapag ang unang sagot ay masyadong malawak o masyadong manipis.

  • intelligent_search — magsimula dito para sa anumang tanong sa base ng code sa natural na wika; ruta nito sa semantic, symbol, istruktura, at dependency na paghahanap.
  • find_symbol — alam mo na ang function, klase, o variable na pangalan.
  • dependency_search — blast radius: mga tumatawag, dependent, o epekto bago (at pagkatapos) ng isang pag-edit.
  • get_task_context — hindi pamilyar na lugar; isang bounded na bundle ng mga file, symbols, at dependencies para sa isang paglalarawan ng gawain.
  • repository_context — maglista ng mga naa-access na repositoryo o siyasatin kung paano niresolba ang pangalan ng repositoryo.
  • ask_maguyva na may operation="guidance" — lokal na tulong sa pagpili ng tool at paggamit ng Maguyva (walang repo mutation).

I-install at i-verify ang isang kliyente#

Kunin ang Maguyva sa iyong MCP client at kumpirmahin ang koneksyon sa isang totoong listahan ng repositoryo.

  1. Gumawa ng API key sa app.maguyva.ai (nagsisimula ang mga key sa mgv_).
  2. Kumonekta at mag-index ng kahit isang GitHub repository na naiintindihan mo na.
  3. I-wire ang iyong kliyente gamit ang Gabay sa Pag-install (Claude Code plugin, o native remote config para sa Cursor, VS Code, Windsurf, Zed, at iba pa).
  4. Tanungin ang iyong agent "Anong mga repositoryo ang ikinonekta ko?" — na nagsasagawa ng authentication at repository_context sa dulo hanggang dulo.
  5. Magtanong ng isang tunay na tanong tungkol sa repo na iyon na ang sagot ay maaari mong mamarkahan. Dapat mong makita ang mga path ng file at mga numero ng linya mula sa naka-index na puno.

Natigil sa mga susi, tulay, o nawawalang mga repo? Pag-troubleshoot.

Magtanong bago ka mag-edit#

Imapa ang mga symbol at blast radius bago baguhin ang nakabahaging code. Hindi binabago ng mga tool ng Maguyva ang iyong mga repository — ipinapaalam nila ang pag-edit na inilalapat ng iyong kliyente nang lokal.

  1. Kung alam mo ang pangalan ng symbol, tawagan ang find_symbol upang mapunta sa mga kahulugan at paggamit.
  2. Kung mayroon ka lang paglalarawan ng gawain ("idagdag ang SSO", "ayusin ang webhook sa pagsingil"), magsimula sa get_task_context o intelligent_search.
  3. Bago i-edit ang isang nakabahaging symbol, tawagan ang dependency_search na may mga dependent/impact analysis (o pumasa sa mga binagong landas para sa PR-style na epekto) para makita mo ang blast radius.
  4. Buksan ang mga binanggit na file (lokal na read para sa mga file sa disk; get_file para sa remote/cross-repo path) at kumpirmahin ang plano laban sa totoong code.
  5. Pagkatapos ng pag-edit, muling suriin ang parehong mga symbol na may dependency_search (kabilang ang pag-verify pagkatapos ng pag-edit kapag sinusuportahan ng iyong kliyente ang mga flag ng pag-verify) para malutas pa rin ng mga tumatawag gaya ng inaasahan.

Buong mga parameter: MCP API Sanggunian.

Maghanap, pagkatapos ay baguhin#

Isang default na agent loop: i-explore → pin symbols → i-edit gamit ang ebidensya.

  1. Magsimula sa intelligent_search at isang query sa simpleng wika ("paano gumagana ang pag-expire ng session", "nasaan ang retry logic").
  2. Makitid na may mga filter ng wika o path kapag maingay ang unang window.
  3. I-promote ang mga promising hit sa find_symbol o dependency_search sa halip na muling itanong ang parehong hindi malinaw na tanong.
  4. Gamitin lang ang get_file kapag kailangan mo ng partikular na naka-index na landas na wala sa disk.
  5. I-edit sa iyong normal na tool ng kliyente. Ang Maguyva ay para sa pagtuklas at pag-verify — hindi nagsusulat.

Bakit gumagana ang loop na ito: Paano Ito Gumagana.

Walang laman o manipis na mga resulta#

Kapag walang naibalik na kapaki-pakinabang ang mga tool, ayusin ang resolution at pag-index bago muling isulat ang query nang tuluyan.

  1. Kumpirmahin na ang repository ay konektado at tapos na ang pag-index sa app.maguyva.ai.
  2. Suriin ang string ng imbakan: Ginagamit ng "owner/repo" ang default na sangay; Pini-pin ng "owner/repo:branch" ang isang sangay. Ang pagtutugma ay case-insensitive, hindi malabo — hindi auto-correct ang mga typo.
  3. Tawagan ang repository_context gamit ang action="info" at siyasatin ang resolution metadata (halimbawa metadata.resolution_reason).
  4. Alisin lamang ang repository kapag ang iyong MCP na kliyente ay nag-supply ng default na kahilingan o maaaring ma-access ng key ang eksaktong isang repositoryo; kung hindi ay ipasa ito nang tahasan.
  5. Subukang muli gamit ang isang mas partikular na query, isang kilalang pangalan ng symbol sa pamamagitan ng find_symbol, o isang filter ng wika/path. Kung ang koneksyon mismo ay sira, gamitin ang Pag-troubleshoot.

Mga pagkabigo sa pag-setup: Pag-troubleshoot.

Magtrabaho sa maraming repositoryo#

I-target ang tamang na-index na repo kapag ang isang key ay nakakakita ng higit sa isa.

  1. Tawagan ang repository_context gamit ang action="list" nang isang beses upang malaman ang eksaktong mga slug na maaaring hanapin ng iyong key.
  2. Ipasa ang repository nang tahasan sa paghahanap at mga tool ng symbol kapag kailangan mo ng hindi default na repo (halimbawa, "owner/other-repo" o "owner/other-repo:develop").
  3. Panatilihin ang isang tanong = isang repositoryo maliban kung sinasadya mong ihambing ang mga repo sa magkakahiwalay na tawag.
  4. Gamitin ang get_file kapag ang file ay nakatira sa isang naka-index na repo na hindi ang iyong kasalukuyang gumaganang puno.
  5. Tandaan: ang mga tool ay hindi kailanman sumulat sa GitHub — multi-repo context ay para lamang sa pagbabasa at pagpaplano.

Mga detalye ng format ng repository: MCP API Sanggunian.

Bago sa Maguyva? Maglakad muna ng Quickstart, pagkatapos ay bumalik dito para sa day-two loops.

Mga susunod na hakbang#