Come posso aggiungere strumenti o estensioni personalizzate a Gemelli CLI

estendendo la CLI GEMINI con strumenti personalizzati tramite MCP

Gemelli CLI è progettato per essere estensibile attraverso il Model Context Protocol (MCP). MCP funge da modo standardizzato per collegare servizi e capacità esterne (strumenti) alla CLI Gemelli. Configurando i server MCP, Gemini CLI può integrare questi strumenti esterni senza soluzione di continuità nel suo flusso di lavoro di comando e ragionamento basato sull'IA.

- Impostazione dei server MCP:
Si avvia configurando i server MCP nel file Impostazioni CLI Gemini, in genere presente su `~/.gemini/impostazioni.json`. Questo file JSON configura ciò con cui server MCP con cui connettersi, inclusi i dettagli della connessione e l'autenticazione, se necessario.

- Utilizzo dei server MCP esistenti o personalizzati:
Molti server MCP esistenti si interfacciano con servizi popolari come GitHub, Gitlab, Firebase, database o generazione di media. Per funzionalità veramente personalizzate, è possibile creare i tuoi server MCP utilizzando l'SDK MCP disponibile in linguaggi come Python o TypeScript. Ciò consente di ospitare qualsiasi logica o strumento personalizzata come server MCP.

- Configurazione dei server MCP:
Nel file `impostazioni.json`, i server MCP sono definiti con i loro nomi, tipi di server, comandi di connessione o URL, token per l'autenticazione e eventuali parametri specializzati. Una volta configurato, Gemini CLI si collegherà a questi server all'avvio.

- Scoperta e utilizzo degli strumenti:
Dopo la connessione, i server MCP espongono strumenti che Gemini CLI scopre automaticamente. Puoi elencare e descrivere questi strumenti con comandi come `/MCP` e`/MCP Desc`. L'agente AI li integra quindi in modo nativo nel suo flusso decisionale e di esecuzione, selezionando gli strumenti secondo necessità in base ai prompt dell'utente senza intervento manuale.

Creazione di estensioni CLI Gemelli

Oltre ai server MCP, Gemini CLI supporta un concetto di livello superiore chiamato Extensions, che raggruppano i server MCP, i file di contesto e i comandi personalizzati per estendere la funzionalità della CLI GEMINI.

- Posizione dell'estensione:
Le estensioni possono risiedere in due posizioni primarie: `/.Gemini/Extensions/` o `/.Gemini/Extensions/`. Gemini CLI carica tutte le estensioni che si trovano in entrambe le posizioni all'avvio, con estensioni specifiche dell'area di lavoro che si estendono sulle versioni di directory della casa se si verificano conflitti di nome.

- Struttura di estensione:
Ogni estensione è una directory che prende il nome dall'estensione (ad esempio, `my-estension`) che contiene un file di configurazione chiamato` gemini-extension.json`. Questo JSON include configurazioni di metadati e server.

- Contenuto di gemini-extension.json:
Le chiavi tipiche in questo file includono:

- `Nome`: nome di estensione univoco.
- `versione`: versione di estensione.
- `McPservers`: una mappa dei server MCP configurati dall'estensione, ad esempio comandi per avviare i server MCP personalizzati.
- `contextFileName`: opzionale. Nome del file di contesto caricato come contesto dell'area di lavoro per l'estensione, le impostazioni predefinite sono `gemini.md`.
- `ExcrudeTools`: Array Specifica di strumenti o comandi di strumenti da escludere, utili per bloccare le operazioni pericolose o indesiderate.

- Comandi personalizzati nelle estensioni:
Le estensioni possono fornire comandi di slash personalizzati posizionando i file di definizione dei comandi `.toml` all'interno di una sottodirectory` comandi/`all'interno della directory di estensione. Questi comandi sono definiti in modo simile ai comandi specifici dell'utente o del progetto.

- Unisci il comportamento:
Quando si avvia la CLI GEMINI, unisce le configurazioni di estensione con le impostazioni principali dell'utente e gli strumenti integrati, risolvendo i conflitti dando priorità alle impostazioni dell'area di lavoro.

Creazione di comandi di slash personalizzato con file TOML

Un modo flessibile per aggiungere comandi riutilizzabili (strumenti) è utilizzando i file `.toml` come comandi di slash personalizzati.

- Posizione:
Metti i file di comandi Toml nella `~/.gemini/comandi/` per i comandi globali o nella directory del progetto-locale `.gemini/comandi/`.

- Formato Toml:
Questi file definiscono il comando, i modelli di prompt e possono incorporare argomenti con segnaposto come ``. Supportano anche l'esecuzione del comando shell all'interno del prompt usando la sintassi come `! {...}` per incorporare lo scripting.

- utilizzo:
Questi comandi possono essere invocati direttamente in Gemini CLI tramite comandi slash come `/myCommand`, consentendo facilmente flussi di lavoro o integrazioni script.

Esecuzione di script Python personalizzati e comandi Shell

- Poiché Gemini CLI supporta l'esecuzione di comandi e script shell, è possibile attivare script Python personalizzati o altri programmi come parte del server MCP o dei flussi di lavoro di comando personalizzati.

- Ad esempio, uno script Python che genera PDF da risposte CLI Gemini potrebbe essere avvolto in un server MCP o eseguito come comando shell in un comando TOML personalizzato, che consente flussi di lavoro di una generazione di un comando.

Integrazione con IDE e ambiente

- Le estensioni della CLI GEMINI possono anche migliorare l'integrazione con IDE come VS Codice condividendo il contesto dell'area di lavoro (file, posizione del cursore, selezioni), abilitando flussi di lavoro di assistenza al codice AI.

- Le estensioni e i server MCP aiutano a integrare flussi di lavoro su misura direttamente nell'ambiente CLI o IDE, migliorando la produttività e la flessibilità della toolchain.

Riepilogo del processo per aggiungere strumenti o estensioni personalizzate

1. Decidi l'ambito dello strumento personalizzato:
Determina se si tratta di un semplice comando personalizzato, uno script o un servizio esterno a tutti gli effetti.

2. Per semplici comandi personalizzati:
Crea file `.toml` che definiscono i comandi slash e inseriscili nella cartella dei comandi appropriati.

3. Per servizi esterni o logica complessa:
Sviluppa un server MCP utilizzando l'SDK MCP (linguaggi di supporto come Python o TypeScript) che espone le funzionalità dello strumento tramite API standardizzata.

4. Configura server MCP in `impostazioni.json` o estensione:
Aggiungi la voce di configurazione del server MCP (con comando o URL) direttamente nella configurazione dell'utente `~/.gemini/impostazioni.json` o all'interno di un file` gemini-extension.json` all'interno di una directory di estensione.

5. Opzionalmente raggruppare in un'estensione:
Controlla i server MCP, i comandi personalizzati e i file di contesto in una struttura di directory di estensione in `.gemini/estensioni/`.

6. Avvia o riavvia Gemelli CLI:
Gemini CLI carica tutte le configurazioni e i server MCP all'avvio, strumenti personalizzati integranti automaticamente.

7. Usa e verifica gli strumenti:
Usa comandi come `/MCP` e`/MCP Desc` per confermare la disponibilità degli strumenti e interagire con le tue aggiunte personalizzate.

Vantaggi di questa architettura

- Modularità: gli strumenti funzionano come server MCP separati, rendendo lo sviluppo indipendente e scalabile.

- Integrazione dinamica: gli strumenti appaiono automaticamente nei flussi di lavoro della CLI GEMINI senza codifica hard.

- Sicurezza e controllo: le estensioni possono limitare quali strumenti o comandi di shell sono consentiti, prevenendo l'abuso.

- Riusabilità: pacchetto estensioni flussi di lavoro completi, condivisibili tra progetti o team.

- Comunità ed ecosistema: molti server e estensioni MCP sono disponibili o possono essere contribuiti in rapida espansione delle capacità della CLI GEMINI.

Questa architettura consente di integrare praticamente qualsiasi strumento, script o servizio esterno nell'ecosistema CLI Gemini, aumentando la produttività e la personalizzazione.

***

Questa risposta fornisce una spiegazione approfondita dei meccanismi di integrazione personalizzati e di integrazione dell'estensione CLI Gemini, tra cui server MCP, imballaggi di estensione, comandi personalizzati e integrazione di script, che soddisfano la lunghezza e i dettagli richiesti. Se lo si desidera, è possibile fornire ulteriori dettagli sull'utilizzo di MCP SDK o sulle configurazioni di esempio.