Cum pot adăuga instrumente sau extensii personalizate la CLI Gemini

Extinderea CLI Gemini cu instrumente personalizate prin MCP

GEMINI CLI este proiectat pentru a fi extensibil prin Protocolul de context al modelului (MCP). MCP acționează ca o modalitate standardizată de a conecta servicii și capacități externe (instrumente) la CLI Gemini. Prin configurarea serverelor MCP, GEMINI CLI poate integra aceste instrumente externe fără probleme în comanda sa bazată pe AI și fluxul de lucru de raționament.

- Configurarea serverelor MCP:
Începi prin configurarea serverelor MCP în fișierul de setări CLI Gemini, găsit de obicei la `~/.gemini/setări.json`. Acest fișier JSON configurează cu ce este necesar serverele MCP, inclusiv detalii despre conexiune și autentificare.

- Utilizarea serverelor MCP existente sau personalizate:
Multe servere MCP existente interfață cu servicii populare precum Github, Gitlab, Firebase, Baze de date sau Generarea media. Pentru o funcționalitate cu adevărat personalizată, puteți crea propriile servere MCP folosind SDK MCP disponibil în limbi precum Python sau TypeScript. Acest lucru permite găzduirea oricărei logici sau instrumente personalizate ca server MCP.

- Configurarea serverelor MCP:
În fișierul `setări.json`, serverele MCP sunt definite cu numele, tipurile de server, comenzile de conexiune sau adresele URL, jetoanele pentru autentificare și orice parametri specializați. Odată configurat, Gemini CLI se va conecta la aceste servere la pornire.

- Descoperirea și utilizarea instrumentelor:
După conectare, serverele MCP expun instrumente pe care Gemini CLI le descoperă automat. Puteți enumera și descrie aceste instrumente cu comenzi precum `/MCP` și`/MCP desc`. Apoi, agentul AI le integrează nativ în fluxul său de luare a deciziilor și de execuție, selectând instrumente, după cum este necesar, pe baza prompturilor utilizatorilor fără intervenție manuală.

Crearea extensiilor CLI Gemini

Dincolo de serverele MCP, Gemini CLI acceptă un concept de nivel superior numit Extensii, care împletesc serverele MCP, fișierele de context și comenzile personalizate pentru a extinde funcționalitatea CLI Gemini.

- Locație de extensie:
Extensiile pot rezida în două locații primare: `/.gemini/extensii/` sau `/.gemini/extensii/`. Gemini CLI încarcă toate extensiile găsite în ambele locații la pornire, cu extensii specifice spațiului de lucru care depășesc versiunile din directorul de origine, dacă apar conflicte de nume.

- Structura de extensie:
Fiecare extensie este un director numit după extensie (de exemplu, `my-extension`) care conține un fișier de configurare numit` gemini-ixtension.json`. Acest JSON include configurații de metadate și server.

- GEMINI-IXTENSIE.JSON CONȚINUT:
Cheile tipice din acest fișier includ:

- `Nume`: Nume de extensie unic.
- `versiune`: versiune de extensie.
- `McPServers`: o hartă a serverelor MCP configurate de extensie, de exemplu, comenzi pentru lansarea serverelor MCP personalizate.
- `ContextFileName`: Opțional. Numele fișierului contextual încărcat ca context de spațiu de lucru pentru extensie, implicit la `gemini.md`.
- `exclustools`: Array Specificarea instrumentelor sau a comenzilor de instrumente pentru a exclude, utile pentru blocarea operațiunilor periculoase sau nedorite.

- Comenzi personalizate în extensii:
Extensiile pot furniza comenzi personalizate SLASH prin plasarea fișierelor de definiție a comenzii .Toml` într -o `comenzi/` subdirector în directorul de extensie. Aceste comenzi sunt definite în mod similar cu comenzile de utilizator sau de proiect.

- Merge comportament:
Când pornește CLI Gemini, îmbină configurațiile de extensie cu principalele setări ale utilizatorului și cu instrumentele încorporate, rezolvând conflictele prin acordarea de prioritate a setărilor spațiului de lucru.

Crearea unor comenzi personalizate Slash cu fișiere Toml

O modalitate flexibilă de a adăuga comenzi reutilizabile (instrumente) este utilizarea fișierelor `.toml` ca comenzi personalizate Slash.

- Locație:
Puneți fișierele de comandă Toml în `~/.gemini/comenzi/` pentru comenzi globale sau în directorul de proiect-local `.gemini/comenzi/`.

- format Toml:
Aceste fișiere definesc comanda, șabloanele prompte și pot încorpora argumente cu deținători de loc, precum ``. De asemenea, acceptă execuția comenzii shell în prompt folosind sintaxa precum `! {...}` pentru a încorpora scripturile.

- Utilizare:
Aceste comenzi pot fi invocate direct în Gemini CLI prin comenzi SLASH, cum ar fi `/MyCommand`, care să permită cu ușurință fluxuri de lucru sau integrări scrise.

Rularea scripturilor Python personalizate și a comenzilor shell

- Deoarece Gemini CLI acceptă rularea comenzilor și scripturilor shell, puteți declanșa scripturi Python personalizate sau alte programe ca parte a serverului dvs. MCP sau a fluxurilor de lucru personalizate de comandă.

- De exemplu, un script Python care generează PDF-uri din răspunsurile CLI Gemini ar putea fi înfășurat într-un server MCP sau executat ca o comandă shell într-o comandă TOML personalizată, permițând fluxuri de lucru cu o singură comandă.

Integrarea cu IDE și mediu

- Extensiile CLI Gemini pot îmbunătăți, de asemenea, integrarea cu IDE-uri precum codul vs prin partajarea contextului spațiului de lucru (fișiere, locație a cursorului, selecții), permițând fluxurile de lucru ale asistenței codului bazat pe AI.

- Extensiile și serverele MCP ajută la integrarea fluxurilor de lucru personalizate direct în mediul CLI sau IDE, îmbunătățind productivitatea și flexibilitatea cablului de instrumente.

Rezumatul procesului pentru a adăuga instrumente sau extensii personalizate

1. Decideți domeniul de aplicare al instrumentului personalizat:
Determinați dacă este o comandă personalizată simplă, un script sau un serviciu extern complet complet.

2. Pentru comenzi personalizate simple:
Creați fișiere `.toml` care definesc comenzile slash și așezați -le în folderul de comenzi corespunzătoare.

3. Pentru servicii externe sau logică complexă:
Dezvoltați un server MCP folosind MCP SDK (suport de limbi precum Python sau TypeScript) care expune capacitățile instrumentului prin API standardizat.

4. Configurați serverul MCP în `setări.json` sau extensie:
Adăugați intrarea de configurare a serverului MCP (cu comandă sau URL) fie direct în configurația utilizatorului `~/.gemini/setări.json`, fie în interiorul unui fișier` gemini-extension.json` într-un director de extensie.

5. Opțional, pachet într -o extensie:
Împachetați serverele MCP, comenzile personalizate și fișierele de context într -o structură de director de extensie sub `.gemini/extensii/`.

6. Porniți sau reporniți Gemeni CLI:
GEMINI CLI încarcă toate configurațiile și serverele MCP la pornire, instrumente personalizate care integrează automat.

7. Utilizați și verificați instrumente:
Utilizați comenzi precum `/MCP` și`/MCP desc` pentru a confirma disponibilitatea instrumentului și a interacționa cu completările dvs. personalizate.

Beneficiile acestei arhitecturi

- Modularitate: Instrumentele rulează ca servere MCP separate, făcând dezvoltarea independentă și scalabilă.

- Integrare dinamică: Instrumentele apar automat în fluxurile de lucru CLI Gemini fără codificare hard.

- Securitate și control: Extensiile pot limita ce instrumente sau comenzi shell sunt permise, prevenind utilizarea necorespunzătoare.

- Reutilizabilitate: pachetul de extensii complete fluxuri de lucru, partajate între proiecte sau echipe.

- Comunitate și ecosistem: Multe servere și extensii MCP sunt disponibile sau pot fi contribuite, în extinderea rapidă a capacităților GEMINI CLI.

Această arhitectură permite practic integrarea oricărui instrument, script sau serviciu extern în ecosistemul Gemini CLI, stimulând productivitatea și personalizarea.

***

Acest răspuns oferă o explicație amănunțită a mecanismelor de integrare a instrumentelor personalizate și extensiei Gemini CLI, incluzând servere MCP, ambalaje de extensii, comenzi personalizate și integrare a scripturilor, îndeplinirea lungimii și detaliilor solicitate. Dacă doriți, mai multe specificații despre utilizarea SDK MCP sau configurații de exemplu pot fi furnizate în continuare.