Πώς μπορώ να προσθέσω προσαρμοσμένα εργαλεία ή επεκτάσεις στο Gemini CLI

Επέκταση του Gemini CLI με προσαρμοσμένα εργαλεία μέσω MCP

Το Gemini CLI έχει σχεδιαστεί για να είναι επεκτάσιμο μέσω του πρωτοκόλλου μοντέλου περιβάλλοντος (MCP). Το MCP λειτουργεί ως τυποποιημένος τρόπος σύνδεσης εξωτερικών υπηρεσιών και δυνατοτήτων (εργαλεία) με το Gemini CLI. Διαμορφώνοντας τους διακομιστές MCP, η Gemini CLI μπορεί να ενσωματώσει αυτά τα εξωτερικά εργαλεία απρόσκοπτα στην εντολή της και τη ροή εργασίας της AI-οδηγού.

- Ρύθμιση διακομιστών MCP:
Ξεκινάτε με τη διαμόρφωση των διακομιστών MCP στο αρχείο ρυθμίσεων Gemini CLI, που συνήθως βρίσκονται στο `~/.gemini/settings.json`. Αυτό το αρχείο JSON διαμορφώνει τους διακομιστές MCP, συμπεριλαμβανομένων των λεπτομερειών σύνδεσης και της ταυτότητας, αν χρειαστεί.

- Χρήση των υφιστάμενων ή προσαρμοσμένων διακομιστών MCP:
Πολλοί υφιστάμενοι διασυνδέσεις διακομιστών MCP με δημοφιλείς υπηρεσίες όπως GitHub, Gitlab, Firebase, βάσεις δεδομένων ή παραγωγή μέσων. Για πραγματικά προσαρμοσμένη λειτουργικότητα, μπορείτε να δημιουργήσετε τους δικούς σας διακομιστές MCP χρησιμοποιώντας το MCP SDK διαθέσιμο σε γλώσσες όπως το Python ή το TypeScript. Αυτό επιτρέπει τη φιλοξενία οποιασδήποτε προσαρμοσμένης λογικής ή εργαλείου ως διακομιστή MCP.

- Ρύθμιση διακομιστών MCP:
Στο αρχείο `settings.json`, οι διακομιστές MCP ορίζονται με τα ονόματά τους, τους τύπους διακομιστών, τις εντολές σύνδεσης ή τις διευθύνσεις URL, τις μάρκες για έλεγχο ταυτότητας και τις εξειδικευμένες παραμέτρους. Μόλις ρυθμιστεί, ο Gemini CLI θα συνδεθεί με αυτούς τους διακομιστές κατά την εκκίνηση.

- Ανακάλυψη και χρήση εργαλείων:
Μετά τη σύνδεση, οι διακομιστές MCP εκθέτουν εργαλεία που ανακαλύπτουν αυτόματα τα Gemini CLI. Μπορείτε να καταγράψετε και να περιγράψετε αυτά τα εργαλεία με εντολές όπως `/MCP` και`/MCP DESC`. Στη συνέχεια, ο πράκτορας AI τους ενσωματώνει εγγενώς στη ροή λήψης αποφάσεων και εκτέλεσης, επιλέγοντας εργαλεία ανάλογα με τις ανάγκες που βασίζονται σε προτροπές χρηστών χωρίς χειροκίνητη παρέμβαση.

Δημιουργία επεκτάσεων CLI Gemini

Πέρα από τους διακομιστές MCP, το Gemini CLI υποστηρίζει μια ιδέα υψηλότερου επιπέδου που ονομάζεται Extensions, οι οποίες συνδέουν τους διακομιστές MCP, τα αρχεία περιβάλλοντος και τις προσαρμοσμένες εντολές για την επέκταση της λειτουργικότητας του Gemini CLI.

- Τοποθεσία επέκτασης:
Οι επεκτάσεις μπορούν να διαμένουν σε δύο πρωτογενείς τοποθεσίες: `/.gemini/extensions/` ή `/.gemini/extensions/`. Το Gemini CLI φορτώνει όλες τις επεκτάσεις που βρέθηκαν και στις δύο θέσεις κατά την εκκίνηση, με εξειδικευμένες επεκτάσεις που προκύπτουν από το χώρο των εκδοτικών εκδοτικών καταλόγων, αν προκύψουν συγκρούσεις ονόματος.

- Δομή επέκτασης:
Κάθε επέκταση είναι ένας κατάλογος που ονομάζεται μετά την επέκταση (π.χ., "my-extension") που περιέχει ένα αρχείο διαμόρφωσης που ονομάζεται `gemini-extension.json '. Αυτό το JSON περιλαμβάνει μεταδεδομένα και διαμορφώσεις διακομιστή.

- Περιεχόμενο gemini-extension.json:
Τα τυπικά κλειδιά σε αυτό το αρχείο περιλαμβάνουν:

- `name`: μοναδικό όνομα επέκτασης.
- `Έκδοση`: Έκδοση επέκτασης.
- `McPservers`: Ένας χάρτης διακομιστών MCP που διαμορφώνονται από την επέκταση, π.χ. εντολές για την εκκίνηση προσαρμοσμένων διακομιστών MCP.
- `contextFileName`: Προαιρετικό. Όνομα του αρχείου περιβάλλοντος φορτωμένο ως πλαίσιο χώρου εργασίας για την επέκταση, προεπιλογή στο `gemini.md`.
- `Αποκλεισμός των εργαλείων που καθορίζουν τα εργαλεία ή τις εντολές εργαλείων για να αποκλειστούν, χρήσιμες για την παρεμπόδιση των επικίνδυνων ή ανεπιθύμητων εργασιών.

- Προσαρμοσμένες εντολές σε επεκτάσεις:
Οι επεκτάσεις μπορούν να παρέχουν προσαρμοσμένες εντολές SLASH τοποθετώντας αρχεία ορισμού εντολών ".toml` εντός ενός υποκατευμάτων εντολών/` εντός του καταλόγου επέκτασης. Αυτές οι εντολές ορίζονται ομοίως με τις εντολές που σχετίζονται με το χρήστη ή το έργο.

- Συμπεριφορά συγχώνευσης:
Όταν ξεκινά η Gemini CLI, συγχωνεύει τις διαμορφώσεις επέκτασης με τις βασικές ρυθμίσεις και τα ενσωματωμένα εργαλεία του χρήστη, την επίλυση συγκρούσεων δίνοντας προτεραιότητα στις ρυθμίσεις του χώρου εργασίας.

Δημιουργία προσαρμοσμένων εντολών slash με αρχεία Toml

Ένας ευέλικτος τρόπος για να προσθέσετε επαναχρησιμοποιήσιμες εντολές (εργαλεία) είναι η χρήση αρχείων ".toml` ως προσαρμοσμένες εντολές slash.

- Τοποθεσία:
Τοποθετήστε τα αρχεία εντολών TOML σε `~/.gemini/commands/` για παγκόσμιες εντολές ή στον κατάλογο του έργου-τοπικό .gemini/commands/`.

- μορφή Toml:
Αυτά τα αρχεία καθορίζουν την εντολή, τα πρότυπα προώθησης και μπορούν να ενσωματώσουν επιχειρήματα με θέματα θέσης όπως `}. Υποστηρίζουν επίσης την εκτέλεση εντολών κελύφους μέσα στην προτροπή χρησιμοποιώντας τη σύνταξη όπως `! {...}` Για να ενσωματώσει το scripting.

- Χρήση:
Αυτές οι εντολές μπορούν να χρησιμοποιηθούν απευθείας στο Gemini CLI μέσω εντολών Slash όπως το `/myCommand`, επιτρέποντας εύκολα τις ροές εργασίας ή τις ενοποιήσεις.

Εκτέλεση προσαρμοσμένων σεναρίων Python και εντολών κελύφους

- Δεδομένου ότι το Gemini CLI υποστηρίζει τις εντολές και τα σενάρια που εκτελούν κέλυφος, μπορείτε να ενεργοποιήσετε τα προσαρμοσμένα σενάρια Python ή άλλα προγράμματα ως μέρος του διακομιστή MCP ή των προσαρμοσμένων ροών εργασίας εντολών.

- Για παράδειγμα, ένα σενάριο Python που παράγει PDFs από τις απαντήσεις του Gemini CLI θα μπορούσε να τυλιχτεί σε διακομιστή MCP ή να εκτελεστεί ως εντολή κελύφους σε μια εντολή Custom TOML, επιτρέποντας τις ροές εργασίας γενιάς ενός κυβερνήτη.

Ενσωμάτωση με IDE και περιβάλλον

- Οι επεκτάσεις Gemini CLI μπορούν επίσης να ενισχύσουν την ενσωμάτωση με IDE όπως ο κώδικας VS με την κοινή χρήση του πλαισίου χώρου εργασίας (αρχεία, τοποθεσία δρομέα, επιλογές), επιτρέποντας τις ροές εργασιών βοήθειας για τον κώδικα AI.

- Οι επεκτάσεις και οι διακομιστές MCP βοηθούν στην ενσωμάτωση προσαρμοσμένων ροών εργασίας απευθείας στο περιβάλλον CLI ή IDE, βελτιώνοντας την παραγωγικότητα και την ευελιξία των εργαλείων.

Περίληψη της διαδικασίας για την προσθήκη προσαρμοσμένων εργαλείων ή επεκτάσεων

1. Αποφασίστε το εύρος του προσαρμοσμένου εργαλείου:
Προσδιορίστε εάν πρόκειται για μια απλή προσαρμοσμένη εντολή, ένα σενάριο ή μια πλήρως εξοπλισμένη εξωτερική υπηρεσία.

2. Για απλές προσαρμοσμένες εντολές:
Δημιουργήστε αρχεία `.toml` Ορίζοντας εντολές SLASH και τοποθετήστε τα στο κατάλληλο φάκελο εντολών.

3. Για εξωτερικές υπηρεσίες ή σύνθετη λογική:
Αναπτύξτε έναν διακομιστή MCP χρησιμοποιώντας το MCP SDK (γλώσσες υποστήριξης όπως το Python ή το TypeScript) που εκθέτουν τις δυνατότητες εργαλείων μέσω τυποποιημένου API.

4. Ρύθμιση του διακομιστή MCP σε `settings.json` ή επέκταση:
Προσθέστε την καταχώρηση διαμόρφωσης του διακομιστή MCP (με εντολή ή διεύθυνση URL) είτε απευθείας στο Config χρήστη `~/.gemini/settings.json` ή μέσα σε ένα αρχείο` gemini-extension.json 'μέσα σε έναν κατάλογο επέκτασης.

5. Προαιρετικά πακέτο σε μια επέκταση:
Συσκευάστε τους διακομιστές MCP, τις προσαρμοσμένες εντολές και τα αρχεία περιβάλλοντος σε δομή καταλόγου επέκτασης κάτω από `.gemini/Extensions/`.

6. Ξεκινήστε ή επανεκκινήστε το Gemini CLI:
Το Gemini CLI φορτώνει όλες τις διαμορφώσεις και τους διακομιστές MCP κατά την εκκίνηση, αυτόματη ενσωμάτωση προσαρμοσμένων εργαλείων.

7. Χρησιμοποιήστε και επαληθεύστε τα εργαλεία:
Χρησιμοποιήστε εντολές όπως `/MCP` και`/MCP DESC` για να επιβεβαιώσετε τη διαθεσιμότητα εργαλείων και να αλληλεπιδράσετε με τις προσαρμοσμένες προσθήκες σας.

Οφέλη αυτής της αρχιτεκτονικής

- Modularity: Τα εργαλεία εκτελούνται ως ξεχωριστοί διακομιστές MCP, καθιστώντας την ανάπτυξη ανεξάρτητων και κλιμακωτών.

- Δυναμική ενσωμάτωση: Τα εργαλεία εμφανίζονται αυτόματα στις ροές εργασίας του Gemini CLI χωρίς σκληρή κωδικοποίηση.

- Ασφάλεια και έλεγχος: Οι επεκτάσεις μπορούν να περιορίσουν ποια εργαλεία ή εντολές κελύφους επιτρέπονται, αποτρέποντας την κατάχρηση.

- Επαναχρησιμοποίηση: Πακέτο επεκτάσεων Πλήρεις ροές εργασίας, κοινόχρηστα σε έργα ή ομάδες.

- Κοινοτικό και οικοσύστημα: Πολλοί διακομιστές και επεκτάσεις MCP είναι διαθέσιμες ή μπορούν να συνεισφέρονται, αναπτύσσοντας τις δυνατότητες του Gemini CLI.

Αυτή η αρχιτεκτονική επιτρέπει σχεδόν οποιοδήποτε εξωτερικό εργαλείο, σενάριο ή υπηρεσία να ενσωματωθεί στο οικοσύστημα Gemini CLI, ενισχύοντας την παραγωγικότητα και την προσαρμογή.

***

Αυτή η απάντηση παρέχει μια διεξοδική εξήγηση των μηχανισμών ολοκλήρωσης του Gemini CLI και της επέκτασης ενσωμάτωσης, συμπεριλαμβανομένων των διακομιστών MCP, της συσκευασίας επέκτασης, των προσαρμοσμένων εντολών και της ενσωμάτωσης σεναρίων, την ικανοποίηση του μήκους και των λεπτομερειών που ζητούνται. Εάν επιθυμείτε, μπορούν να παρέχονται περισσότερες λεπτομέρειες σχετικά με τη χρήση MCP SDK ή τις παραδείγματα παραδείγματος.