Jak mohu přidat vlastní nástroje nebo rozšíření do Gemini CLI

Rozšiřování gemini cli s vlastními nástroji přes MCP

Gemini CLI je navržen tak, aby byl rozšiřitelný prostřednictvím modelového kontextového protokolu (MCP). MCP funguje jako standardizovaný způsob, jak propojit externí služby a schopnosti (nástroje) s Gemini CLI. Konfigurace serverů MCP může Gemini CLI bez problémů integrovat tyto externí nástroje do svého příkazu řízeného AI a uvažování.

- Nastavení serverů MCP:
Začnete nakonfigurováním serverů MCP v souboru Nastavení gemini CLI, obvykle nalezeno na `~/.gemini/Settings.json`. Tento soubor JSON nakonfiguruje to, s čím se servery MCP propojí, včetně údajů o připojení a ověřování v případě potřeby.

- Používání stávajících nebo vlastních serverů MCP:
Mnoho existujících serverů MCP propojí s populárními službami, jako jsou GitHub, Gitlab, Firebase, databáze nebo generování médií. Pro skutečně vlastní funkčnost můžete vytvořit vlastní servery MCP pomocí MCP SDK dostupné v jazycích, jako je Python nebo TypeScript. To umožňuje hostování jakékoli vlastní logiky nebo nástroje jako server MCP.

- Konfigurace serverů MCP:
V souboru `settings.json` jsou servery MCP definovány s jejich názvy, typy serverů, příkazy připojení nebo adresy URL, tokeny pro ověřování a jakýmikoli specializovanými parametry. Po nakonfigurování se Gemini CLI připojí k těmto serverům při spuštění.

- Objev a použití nástrojů:
Po připojení vystavují servery MCP nástroje, které Gemini CLI automaticky objevuje. Tyto nástroje můžete uvést a popsat příkazy jako `/mcp` a`/MCP desc`. Agent AI je poté nativně integruje do svého rozhodovacího a prováděcího toku a podle potřeby vybírá nástroje na základě uživatelských pokynů bez ručního zásahu.

Vytváření prodloužení gemini cli

Kromě serverů MCP podporuje Gemini CLI koncept vyšší úrovně s názvem Extensions, který spojí servery MCP, kontextové soubory a vlastní příkazy pro rozšíření funkce Gemini CLI.

- Umístění prodloužení:
Prodloužení může být umístěna na dvou primárních místech: `/.Gemini/Extensions/` nebo `/.Gemini/Extensions/`. Gemini CLI načte všechna rozšíření na obou místech na spuštění, přičemž rozšíření specifické pro pracovní prostor převažují verze domácího adresáře, pokud vzniknou konflikty názvu.

- Struktura rozšíření:
Každé rozšíření je adresář pojmenovaný po rozšíření (např. `My-extension`), který obsahuje konfigurační soubor s názvem` gemini-extension.json`. Tento JSON obsahuje konfigurace metadat a serveru.

- Gemini-Extension.json Content:
Mezi typické klíče v tomto souboru patří:

- `name`: Unikátní název rozšíření.
- `Version`: Extension Version.
- `mcpServers`: A map of MCP servers configured by the extension, e.g., commands to launch custom MCP servers.
- `ContextFileName`: Volitelné. Název kontextového souboru načteného jako kontext pracovního prostoru pro rozšíření, výchozí hodnoty na `gemini.md`.
- `ExcludeTools`: Pole určující nástroje nebo příkazy nástrojů k vyloučení, užitečné pro blokování nebezpečných nebo nežádoucích operací.

- Vlastní příkazy v rozšířeních:
Rozšíření mohou poskytnout vlastní příkazy lomítka umístěním souborů definice příkazu `.TOML` dovnitř podadresáře příkazů/` podadresáře v adresáři rozšíření. Tyto příkazy jsou definovány podobně jako příkazy specifické pro uživatele nebo projekt.

- Sloučit chování:
Když spustí Gemini CLI, sloučí konfigurace rozšíření s hlavními nastaveními a vestavěné nástroje uživatele a vyřeší konflikty tím, že udělí prioritu nastavení pracovního prostoru.

Vytváření vlastních příkazů lomítka pomocí souborů Toml

Flexibilní způsob, jak přidat opakovaně použitelné příkazy (nástroje), je použití souborů `.TOML` jako vlastní příkazy lomítka.

- Poloha:
Vložte příkazové soubory Toml do `~/.gemini/příkazů/` pro globální příkazy nebo do projektu-local `.Gemini/příkazy/` adresář.

- Formát Toml:
Tyto soubory definují příkaz, výzvy šablony a mohou zahrnovat argumenty s zástupnými symboly jako ``. Podporují také provádění příkazů Shell v rámci výzvy pomocí syntaxe jako `! {...}` pro vložení skriptování.

- Použití:
Tyto příkazy lze vyvolat přímo v Gemini CLI pomocí příkazů Slash jako `/myCommand`, což umožňuje snadno skriptované pracovní postupy nebo integrace.

Spuštění vlastních skriptů Python a příkazy

- Vzhledem k tomu, že Gemini CLI podporuje příkazy a skripty spuštěných shellů, můžete spustit vlastní skripty Python nebo jiné programy jako součást pracovního postupu MCP nebo vlastního příkazu.

- Například skript Python generující PDFS z odpovědí Gemini CLI lze zabalit do serveru MCP nebo spuštěn jako příkaz Shell v vlastním příkazu TOML, což umožňuje pracovní postupy s jedním příkazem.

Integrace s IDES a prostředím

- Rozšíření Gemini CLI může také zlepšit integraci s IDE, jako je vs kód, sdílením kontextu pracovního prostoru (soubory, umístění kurzoru, výběry), což umožňuje pracovní postupy pomoci s AI řízenými.

- Rozšíření a servery MCP pomáhají integrovat přizpůsobené pracovní postupy přímo do prostředí CLI nebo IDE, což zvyšuje produktivitu a flexibilitu nástroje.

Shrnutí procesu pro přidání vlastních nástrojů nebo rozšíření

1. Rozhodujte o rozsahu vlastního nástroje:
Zjistěte, zda se jedná o jednoduchý vlastní příkaz, skript nebo plně nalepenou externí službu.

2. pro jednoduché vlastní příkazy:
Vytvořte soubory „

3. Pro externí služby nebo složitá logika:
Vypracovat server MCP pomocí MCP SDK (podpůrné jazyky, jako je Python nebo TypeScript), který odhaluje schopnosti nástroje prostřednictvím standardizovaného API.

4. Nakonfigurujte server MCP v `settings.json` nebo rozšíření:
Přidejte položku konfigurace serveru MCP (s příkazem nebo URL) buď přímo v uživatelské konfiguraci `~/.Gemini/Settings.json` nebo uvnitř souboru` Gemini-Extension.json` v adresáři rozšíření.

5. Volitelně svazek v prodloužení:
Zabalte své servery MCP, vlastní příkazy a kontextové soubory do struktury adresáře rozšíření podle `.Gemini/Extensions/`.

6. Spusťte nebo restartujte gemini cli:
Gemini CLI načte všechny konfigurace a servery MCP na spuštění a automaticky integruje vlastní nástroje.

7. Používejte a ověřte nástroje:
Použijte příkazy jako `/mcp` a`/MCP desc` k potvrzení dostupnosti nástroje a interakci s vašimi vlastními doplňky.

Výhody této architektury

- Modularita: Nástroje běží jako samostatné servery MCP, díky čemuž je vývoj nezávislý a škálovatelný.

- Dynamická integrace: Nástroje se objevují automaticky v pracovních postupech Gemini CLI bez tvrdého kódování.

- Zabezpečení a řízení: Rozšíření mohou omezit, které nástroje nebo příkazy Shell jsou povoleny, což zabraňuje zneužití.

- Opakovaně použitelnost: Balíček rozšíření Kompletní pracovní postupy, sdílené napříč projekty nebo týmy.

- Komunita a ekosystém: K dispozici je mnoho serverů a rozšíření MCP nebo může být přispívání, rychle rozšiřující schopnosti gemini CLI.

Tato architektura umožňuje prakticky jakýkoli externí nástroj, skript nebo službu integrovat do ekosystému Gemini CLI, což zvyšuje produktivitu a přizpůsobení.

***

Tato odpověď poskytuje důkladné vysvětlení vlastních mechanismů integrace nástroje a prodloužení Gemini CLI, včetně serverů MCP, balení rozšíření, vlastních příkazů a integrace skriptování, splnění požadované délky a detailu. V případě potřeby lze dále poskytnout více specifik o využití nebo příkladech MCP SDK.