Za dodajanje orodij ali razširitev po meri Gemini CLI je glavni mehanizem prek protokola konteksta modela (MCP) in razširitvami po meri, ki jih podpira Gemini CLI. Spodaj je podroben vodnik s ključnimi vidiki in koraki za dodajanje orodij ali razširitev po meri v Gemini CLI:
Razširitev Gemini CLI z orodji po meri prek MCP
Gemini CLI je zasnovan tako, da je razširjen s protokolom modelov konteksta (MCP). MCP deluje kot standardiziran način za povezovanje zunanjih storitev in zmogljivosti (orodij) z Gemini CLI. S konfiguriranjem strežnikov MCP lahko Gemini CLI brezhibno integrira ta zunanja orodja v svoj potek zapovedi in sklepanja z AI-poganjanjem.
- Nastavitev strežnikov MCP:
Začnete s konfiguracijo strežnikov MCP v datoteki nastavitve Gemini CLI, ki ga običajno najdete na `~/.Gemini/Settings.json`. Ta datoteka JSON konfigurira, s čim se povežejo strežniki MCP, vključno s podrobnostmi o povezavi in pristnosti, če je potrebno.
- Uporaba obstoječih ali po meri strežnikov MCP:
Številni obstoječi strežniki MCP se povezujejo s priljubljenimi storitvami, kot so GitHub, GitLab, Firebase, baze podatkov ali generacija medijev. Za resnično funkcionalnost po meri lahko ustvarite lastne MCP strežnike z uporabo MCP SDK, ki je na voljo v jezikih, kot sta Python ali TypeScript. To omogoča gostovanje katere koli logike ali orodja po meri kot MCP strežnik.
- Konfiguriranje strežnikov MCP:
V datoteki `settings.json` so strežniki MCP opredeljeni z njihovimi imeni, vrstami strežnikov, ukazov za povezavo ali URL -je, žetoni za overjanje in vse specializirane parametre. Ko bo konfiguriran, se bo Gemini CLI povezal s temi strežniki ob zagonu.
- Odkrivanje in uporaba orodij:
Po povezavi MCP strežniki izpostavijo orodja, ki jih Gemini CLI samodejno odkrije. Ta orodja lahko naštejete in opišete z ukazi, kot sta `/mcp` in`/mcp desc`. Agent AI jih nato naročno integrira v svoje odločitve in pretok izvajanja, pri čemer po potrebi izbira orodja na podlagi uporabniških pozivov brez ročnega posredovanja.
Ustvarjanje podaljška Gemini CLI
Poleg strežnikov MCP Gemini CLI podpira koncept višjega nivoja, imenovan Extensions, ki združuje strežnike MCP, kontekstne datoteke in ukaze po meri za razširitev funkcionalnosti Gemini CLI.
- Lokacija podaljška:
Razširitve lahko prebivajo na dveh primarnih lokacijah: `/.gemini/razširitve/` ali `/.gemini/razširitve/`. Gemini CLI nalaga vse razširitve, ki jih najdemo na obeh lokacijah na zagonu, z razširitvami, specifičnimi za delo, ki prevladajo nad različicami domačega imenika, če se pojavijo konflikti imena.
- razširitvena struktura:
Vsaka razširitev je imenik, imenovan po razširitvi (npr. "My-Extension`), ki vsebuje konfiguracijsko datoteko z imenom` gemini-ixtension.json`. Ta JSON vključuje konfiguracije metapodatkov in strežnikov.
- Gemini-Extension.json vsebina:
Tipične tipke v tej datoteki vključujejo:
- `ime`: edinstveno ime razširitve.
- `različica: razširitvena različica.
- `McPSersers`: Zemljevid strežnikov MCP, konfiguriranih s podaljšanjem, npr. Ukazi za zagon strežnikov MCP po meri.
- `contextFileName`: neobvezno. Ime kontekstne datoteke, naložene kot kontekst delovnega prostora za razširitev, privzeto nanaša na `gemini.md`.
- `ExcludeTools`: Array Določitev orodij ali ukazov orodij za izključitev, uporabna za blokiranje nevarnih ali neželenih operacij.
- Ukazi po meri v podaljških:
Razširitve lahko nudijo ukaze poševnika po meri tako, da v podelični imeni `. Ti ukazi so definirani podobno kot uporabniški ali projekt specifični ukazi.
- združitev vedenja:
Ko se Gemini CLI začne, združi konfiguracije razširitve z glavnimi nastavitvami in vgrajenimi orodji uporabnika ter rešuje konflikte tako, da daje prednostne nastavitve delovnega prostora.
Ustvarjanje ukazov po meri po meri s datotekami TOML
Prilagodljiv način za dodajanje ukazov za večkratno uporabo (orodja) je z uporabo `.Toml` datotek kot ukazov po meri po meri.
- Lokacija:
Vstavite ukazne datoteke Toml v `~/.Gemini/ukaze/` za globalne ukaze ali v projektno-lokal `.gemini/ukazi/` imenik.
- format TOML:
Te datoteke definirajo ukaz, hitre predloge in lahko vključijo argumente z lastniki, kot je `
- Uporaba:
Te ukaze se lahko neposredno sklicujejo v Gemini CLI prek poševnih ukazov, kot je `/MyCommand`, kar enostavno omogočajo scenarijske delovne tokove ali integracije.
Zagon skriptov in ukazov po meri Python
- Ker Gemini CLI podpira izvajanje ukazov in skript lupine, lahko sprožite skripte Python ali druge programe po meri kot del vašega strežnika MCP ali po meri Ukaznih tokov po meri.
- Na primer, scenarij Python, ki ustvarja PDF-je iz odzivov Gemini CLI, bi se lahko zavili v strežnik MCP ali izvedli kot ukaz lupine v ukazu TOML po meri, ki omogoča delovne tokove generacije enosmerda.
Integracija z IDE in okoljem
- Razširitve Gemini CLI lahko tudi izboljšajo integracijo z IDE, kot je koda VS, z deljenjem konteksta delovnega prostora (datoteke, lokacija kazalca, izbire), ki omogočajo AI-poganjane procese kode, ki jo poganja AI-poganja.
- Razširitve in strežniki MCP pomagajo vključiti prilagojene delovne tokove neposredno v okolje CLI ali IDE, kar izboljšuje produktivnost in prilagodljivost orodij.
Povzetek postopka za dodajanje orodij ali podaljškov po meri
1. Odločite se za obseg orodja po meri:
Ugotovite, ali gre za preprost ukaz po meri, skript ali popolnoma zdrava zunanja storitev.
2. Za preproste ukaze po meri:
Ustvarite datoteke `.Toml`, ki definirajo ukaze poševnice, in jih postavite v ustrezno mapo ukazov.
3. Za zunanje storitve ali zapleteno logiko:
Razviti strežnik MCP z uporabo MCP SDK (podpornih jezikov, kot sta Python ali TypeScript), ki izpostavlja zmogljivosti orodja prek standardiziranega API -ja.
4. Konfigurirajte MCP strežnik v `settings.json` ali razširitvi:
Dodajte vnos konfiguracije strežnika MCP (z ukazom ali URL) bodisi neposredno v uporabniško konfiguracijo `~/.Gemini/Settings.json` ali znotraj datoteke` gemini-extension.json` v imeniku razširitve.
5. Po izbiri se spustite v podaljšek:
Svoje strežnike MCP, ukaze po meri in kontekstne datoteke pakirajte v strukturo razširitvenega imenika pod `.Gemini/Extensions/`.
6. Začnite ali znova zaženite Gemini CLI:
Gemini CLI naloži vse konfiguracije in MCP strežnike na zagon, samodejno integrirajoča orodja po meri.
7. Uporabite in preverite orodja:
Uporabite ukaze, kot sta `/mcp` in`/mcp desc`, da potrdite razpoložljivost orodja in interakcijo z vašimi dodatki po meri.
Prednosti te arhitekture
- Modularnost: Orodja se izvajajo kot ločeni strežniki MCP, zaradi česar je razvoj neodvisen in razširljiv.
- Dinamična integracija: Orodja se samodejno pojavijo v delovnih tokovih Gemini CLI brez trde kodiranja.
- Varnost in nadzor: Razširitve lahko omejijo, katera orodja ali ukazi za lupine so dovoljena, kar preprečuje zlorabo.
- Ponovna uporaba: paket razširitve Popolno delovnih tokov, deljenja v projektih ali skupinah.
- Skupnost in ekosistem: Na voljo so številni strežniki in razširitve MCP ali pa jih lahko prispevamo, hitro širimo zmogljivosti Gemini CLI.
Ta arhitektura omogoča, da se v ekosistem Gemini CLI vgradi skoraj vsako zunanje orodje, skript ali storitev, kar povečuje produktivnost in prilagoditev.
***
Ta odgovor ponuja temeljito razlago mehanizmov za orodje in razširitev po meri Gemini CLI, vključno s strežniki MCP, razširitvenimi embalaži, ukazi po meri in integracijo skripta, izpolnjevanje zahtevane dolžine in podrobnosti. Po želji lahko naslednje zagotovite več podrobnosti o uporabi MCP SDK ali konfiguracijah z primerom.
Vse informacije temeljijo na avtoritativni dokumentaciji Gemini CLI in virih skupnosti, ki so na voljo od septembra 2025.