Ako môžem pridať vlastné nástroje alebo rozšírenia do Gemini CLI

Rozšírenie Gemini CLI s vlastnými nástrojmi prostredníctvom MCP

Gemini CLI je navrhnutý tak, aby bol rozšírený prostredníctvom modelového kontextového protokolu (MCP). MCP pôsobí ako štandardizovaný spôsob, ako pripojiť externé služby a schopnosti (nástroje) k Gemini CLI. Konfiguráciou serverov MCP dokáže Gemini CLI tieto externé nástroje bezproblémovo integrovať do príkazu riadeného AI a uvažovaním pracovného postupu.

- Nastavenie serverov MCP:
Začnete konfiguráciou serverov MCP v súbore nastavení Gemini CLI, ktoré sa zvyčajne nachádzajú na `~/.gemini/settings.json`. Tento súbor JSON nakonfiguruje, s čím sa má pripojiť servery MCP, vrátane podrobností o pripojení a autentifikácii, ak je to potrebné.

- Používanie existujúcich alebo vlastných serverov MCP:
Mnoho existujúcich serverov MCP sa prepojí s populárnymi službami ako GitHub, GitLab, Firebase, Databázami alebo generovaním médií. Pre skutočne vlastné funkcie si môžete vytvoriť svoje vlastné servery MCP pomocou SDK MCP dostupné v jazykoch ako Python alebo TypeScript. To umožňuje hostenie akejkoľvek vlastnej logiky alebo nástroja ako servera MCP.

- Konfigurácia serverov MCP:
V súbore `settings.json` sú servery MCP definované svojimi názvami, typmi serverov, príkazmi pripojenia alebo adresami URL, tokenmi na autentifikáciu a akýmikoľvek špecializovanými parametrami. Po nakonfigurovaní sa Gemini CLI pripojí k týmto serverom pri štarte.

- Objav a použitie nástrojov:
Po pripojení servery MCP vystavujú nástroje, ktoré Gemini CLI automaticky objavuje. Tieto nástroje môžete uviesť a opísať pomocou príkazov ako `/mcp` a`/mcp desc`. Agent AI ich potom natívne integruje do svojho toku rozhodovania a vykonávania a podľa potreby vyberie nástroje na základe používateľských výziev bez manuálneho zásahu.

Vytváranie rozšírení Gemini CLI

Okrem serverov MCP podporuje Gemini CLI koncept vyššej úrovne s názvom Extensions, ktorý spájajú servery MCP, kontextové súbory a vlastné príkazy na rozšírenie funkcií Gemini CLI.

- Miesto rozšírenia:
Rozšírenia sa môžu nachádzať v dvoch primárnych miestach: `/.gemini/extenzie/` alebo `/.gemini/extensions/`. Gemini CLI načíta všetky rozšírenia nájdené v oboch miestach pri spustení, pričom ak vzniknú konflikty s menami, rozšírenia špecifických pre pracovný priestor, ktoré prechádzajú verzie domáceho adresára.

- Štruktúra rozšírenia:
Každé rozšírenie je adresár pomenovaný po rozšírení (napr. „My-Extension`), ktorý obsahuje konfiguračný súbor s názvom„ Gemini-extension.json “. Tento JSON obsahuje konfigurácie metadát a serverov.

- Gemini-extension.json obsah:
Typické kľúče v tomto súbore zahŕňajú:

- `NAME`: jedinečný názov rozšírenia.
- `Version`: Verzia rozšírenia.
- `McPServers`: Mapa serverov MCP nakonfigurovaných rozšírením, napr. Príkazy na spustenie vlastných serverov MCP.
- `ContextFileName`: voliteľné. Názov kontextového súboru načítaný ako kontext pracovného priestoru pre rozšírenie, predvolená hodnota na `gemini.md`.
- `ExudeTools`: Pole Špecifikujúce nástroje alebo príkazy nástrojov na vylúčenie, užitočné na blokovanie nebezpečných alebo nežiaducich operácií.

- Vlastné príkazy v rozšíreniach:
Rozšírenia môžu poskytnúť vlastné príkazy lomky umiestnením súborov definície príkazu `.Toml` do podadresára` príkazov/`do adresára rozšírenia. Tieto príkazy sú definované podobne ako príkazy špecifické pre používateľa alebo projekt.

- Správanie zlúčenia:
Keď Gemini CLI začne, spája konfigurácie rozšírenia s hlavnými nastaveniami používateľa a vstavanými nástrojmi, čím rieši konflikty tým, že poskytne prioritu nastavení pracovného priestoru.

Vytváranie vlastných príkazov lomítka so súborom TOML

Flexibilný spôsob, ako pridať opakovane použiteľné príkazy (nástroje), je použitie súborov „.toml` ako vlastných príkazov lomítka.

- Umiestnenie:
Vložte príkazové súbory TOML do `~/.gemini/commands/` pre globálne príkazy alebo do projektu-lokálneho `.gemini/commits/` adresár.

- formát TOML:
Tieto súbory definujú príkaz, šablóny s výzvou a môžu obsahovať argumenty so zástupnými symbolmi ako ``. Podporujú tiež vykonanie príkazu shellu v rámci výzvy pomocou syntaxe ako `! {...}` na vloženie skriptovania.

- Použitie:
Tieto príkazy je možné vyvolať priamo v Gemini CLI prostredníctvom príkazov Slash ako `/myCommand`, čo umožňuje ľahko skriptované pracovné toky alebo integrácie.

Spustenie vlastných skriptov Python a príkazy shellu

- Keďže Gemini CLI podporuje spustené príkazy a skripty shellu, môžete spustiť vlastné skripty Python alebo iné programy ako súčasť vášho servera MCP alebo vlastných pracovných tokov príkazov.

- Napríklad Pythonov skript generujúci PDF z odpovedí Gemini CLI možno zabaliť do servera MCP alebo vykonať ako príkaz shell vo vlastnom príkaze TOML, ktorý umožňuje pracovné toky generácie jednej veliteľa.

Integrácia s IDE a prostredím

- Rozšírenia Gemini CLI môžu tiež vylepšiť integráciu s IDE, ako je vs kód zdieľaním kontextu pracovného priestoru (súbory, umiestnenie kurzora, výbery), čo umožňuje pracovné toky pomoci s kódom riadený AI.

- Rozšírenia a servery MCP pomáhajú integrovať pracovné postupy prispôsobených priamo do prostredia CLI alebo IDE, čím sa zlepšuje produktivita a flexibilita nástrojov.

Zhrnutie procesu na pridanie vlastných nástrojov alebo rozšírení

1. Rozhodnite sa o rozsahu vlastného nástroja:
Zistite, či ide o jednoduchý vlastný príkaz, skript alebo plne zavedená externá služba.

2. Pre jednoduché vlastné príkazy:
Vytvorte `.Toml` súbory, ktoré definujú príkazy lomítka a umiestnite ich do príslušného priečinka príkazov.

3. Pre externé služby alebo zložitú logiku:
Vyvinúť server MCP pomocou MCP SDK (podporné jazyky ako Python alebo TypeScript), ktorý odhaľuje možnosti nástrojov prostredníctvom štandardizovaného rozhrania API.

4. Konfigurujte server MCP v `settings.json` alebo rozšírenie:
Pridajte položku konfigurácie servera MCP (s príkazom alebo URL) buď priamo do používateľského konfigurácie `~/.gemini/settings.json` alebo do súboru` gemini-extension.json` v adresári rozšírenia.

5. Voliteľne zväzok v rozšírení:
Zabalte svoje servery MCP, vlastné príkazy a kontextové súbory do štruktúry adresára rozšírenia podľa `.gemini/extensions/`.

6. Začnite alebo reštartujte Gemini CLI:
Gemini CLI načíta všetky konfigurácie a servery MCP pri spustení, automaticky integrujúce vlastné nástroje.

7. Používajte a overte nástroje:
Použite príkazy ako `/mcp` a`/mcp desc` na potvrdenie dostupnosti nástroja a interakciu s vašimi vlastnými doplnkami.

Výhody tejto architektúry

- Modularita: Nástroje prevádzkujú ako samostatné servery MCP, vďaka čomu je vývoj nezávislý a škálovateľný.

- Dynamická integrácia: Nástroje sa zobrazujú automaticky v pracovných postupoch Gemini CLI bez tvrdého kódovania.

- Bezpečnosť a riadenie: Rozšírenia môžu obmedziť, ktoré nástroje alebo príkazy shellu sú povolené, čo zabráni zneužívaniu.

- Opätovné použitie: Extensions Balíček Kompletné pracovné postupy, zdieľanie v rámci projektov alebo tímov.

- Komunita a ekosystém: Mnoho serverov a rozšírení MCP je k dispozícii alebo je možné prispievať, rýchlo sa rozširujú schopnosti Gemini CLI.

Táto architektúra umožňuje, aby bol do ekosystému Gemini CLI prakticky akýkoľvek externý nástroj, skript alebo služba integrovaný do ekosystému Gemini CLI, čo zvyšuje produktivitu a prispôsobenie.

***

Táto odpoveď poskytuje dôkladné vysvetlenie mechanizmov vlastných nástrojov a integrácie rozšírenia Gemini CLI vrátane serverov MCP, balenia rozšírenia, vlastných príkazov a skriptovania integrácie, spĺňania požadovanej dĺžky a detailov. Ak je to potrebné, je možné poskytnúť ďalšie špecifiká týkajúce sa využívania MCP SDK alebo príkladových konfigurácií.