Wie kann ich Gemini CLI benutzerdefinierte Werkzeuge oder Erweiterungen hinzufügen?

Erweiterung Gemini CLI mit benutzerdefinierten Tools über MCP

Gemini CLI ist so konzipiert, dass sie durch das Modellkontextprotokoll (MCP) erweiterbar ist. MCP fungiert als standardisierte Möglichkeit, externe Dienste und Funktionen (Tools) mit Gemini CLI zu verbinden. Durch die Konfiguration von MCP-Servern kann Gemini CLI diese externen Tools nahtlos in den von KI-gesteuerten Befehl und den Argumentations-Workflow integrieren.

- Einrichten von MCP -Servern:
Sie konfigurieren Sie zunächst MCP -Server in der Datei der Gemini CLI -Einstellungen, die normalerweise unter `~/.gemini/setting.json` gefunden wurden. Diese JSON -Datei konfiguriert, mit welchen MCP -Servern sie eine Verbindung herstellen sollen, einschließlich Verbindungsdetails und Authentifizierung, falls erforderlich.

- Verwenden vorhandener oder benutzerdefinierter MCP -Server:
Viele vorhandene MCP -Server werden mit beliebten Diensten wie Github, Gitlab, Firebase, Datenbanken oder Mediengenerierung geschleust. Für wirklich benutzerdefinierte Funktionen können Sie Ihre eigenen MCP -Server mit dem in Sprachen wie Python oder TypeScript verfügbaren MCP -SDK erstellen. Auf diese Weise ermöglicht das Hosting einer benutzerdefinierten Logik oder eines Tools als MCP -Server.

- Konfigurieren von MCP -Servern:
In der Datei "Settings.json" werden MCP -Server mit ihren Namen, Servertypen, Verbindungsbefehlen oder URLs, Token für die Authentifizierung und spezialisierten Parametern definiert. Nach der Konfiguration stellt Gemini CLI beim Start eine Verbindung zu diesen Servern her.

- Entdeckung und Verwendung von Werkzeugen:
Nach der Verbindung stellen die MCP -Server Tools frei, die Gemini CLI automatisch entdeckt. Sie können diese Tools mit Befehlen wie `/mcp` und`/mcp desc` auflisten und beschreiben. Der AI-Agent integriert sie dann nativ in seinen Entscheidungsfindung und Ausführungsfluss und wählt nach Bedarf Tools aus, die auf Eingabeaufforderungen ohne manuelle Eingriffe erforderlich sind.

Erstellen von Gemini CLI -Erweiterungen

Über MCP-Server hinaus unterstützt Gemini CLI ein höheres Konzept mit dem Namen Extensions, das MCP-Server, Kontextdateien und benutzerdefinierte Befehle zusammenbündet, um Gemini CLI-Funktionalität zu erweitern.

- Verlängerungsort:
Erweiterungen können sich an zwei primären Stellen befinden: `/.gemini/extensions/` oder `/.gemini/extensions/`. Gemini CLI lädt alle Erweiterungen, die an beiden Orten beim Start gefunden wurden, wobei Arbeitsspace-spezifische Erweiterungen für die Home-Verzeichnis-Verzeichnisversionen überschrieben werden, wenn Namekonflikte auftreten.

- Erweiterungsstruktur:
Jede Erweiterung ist ein Verzeichnis, das nach der Erweiterung (z. B. `my-Extension`) benannt wurde, die eine Konfigurationsdatei mit dem Namen" Gemini-Oxtesion.json "enthält. Dieser JSON enthält Metadaten- und Serverkonfigurationen.

- Gemini-Extension.json Inhalt:
Typische Schlüssel in dieser Datei umfassen:

- `name`: eindeutiger Erweiterungsname.
- `Version`: Erweiterung Version.
- `mcpservers`: Eine Karte von MCP -Servern, die von der Erweiterung konfiguriert sind, z. B. Befehle, um benutzerdefinierte MCP -Server zu starten.
- `contextFileName`: optional. Name der Kontextdatei als Arbeitsbereichskontext für die Erweiterung, standardmäßig zu `cemini.md`.
- `excludetools`: Array -Angabe von Tools oder Toolbefehlen zum Ausschluss, nützlich, um gefährliche oder unerwünschte Operationen zu blockieren.

- Benutzerdefinierte Befehle in Erweiterungen:
Erweiterungen können benutzerdefinierte Slash -Befehle liefern, indem die Befehlsdefinitionsdateien von `.toml` in einem" Befehl/`Subditionory im Erweiterungsverzeichnis" platziert werden. Diese Befehle sind ähnlich wie Benutzer- oder projektspezifische Befehle definiert.

- Verhalten zusammenführen:
Wenn Gemini CLI beginnt, verschmilzt es Erweiterungskonfigurationen mit den Haupteinstellungen und integrierten Tools des Benutzers, wobei Konflikte aufgelöst werden, indem die Einstellungen der Arbeitsbereiche Priorität gewährt werden.

Erstellen benutzerdefinierter Slash -Befehle mit TOML -Dateien

Eine flexible Möglichkeit, wiederverwendbare Befehle (Tools) hinzuzufügen, besteht darin, `.toml` -Dateien als benutzerdefinierte Slash -Befehle zu verwenden.

- Standort:
Setzen Sie Toml-Befehlsdateien in "~/.Gemini/Befehle/" für globale Befehle oder in das projektlokale `.gemini/commands/`-Verzeichnis ein.

- TOML -Format:
Diese Dateien definieren den Befehl, die Eingabeaufforderung Vorlagen und können Argumente mit Platzhaltern wie <{Args> `enthalten. Sie unterstützen auch die Ausführung der Shell -Befehlsausführung in der Eingabeaufforderung mit Syntax wie `! {...}`, um das Skript einzubetten.

- Verwendung:
Diese Befehle können direkt in Gemini CLI über Slash -Befehle wie `/mycommand` aufgerufen werden, wodurch Skript -Workflows oder Integrationen leicht aktiviert werden.

Ausführen benutzerdefinierter Python -Skripte und Shell -Befehle

- Da Gemini CLI das Ausführen von Shell -Befehlen und -Skripts unterstützt, können Sie im Rahmen Ihres MCP -Servers oder benutzerdefinierten Befehls -Workflows benutzerdefinierte Python -Skripte oder andere Programme auslösen.

- Zum Beispiel könnte ein Python-Skript, das PDFs aus Gemini-CLI-Antworten generiert, in einen MCP-Server eingewickelt oder als Shell-Befehl in einem benutzerdefinierten TOML-Befehl ausgeführt werden, wodurch eine Arbeitsabläufe mit One-Command-Generation aktiviert werden.

Integration in IDES und Umgebung

- Gemini CLI-Erweiterungen können auch die Integration mit IDES wie VS-Code verbessern, indem der Arbeitsbereichskontext (Dateien, Cursor-Speicherort, Auswahl) freigegeben wird, wodurch AI-gesteuerte Code-Hilfs-Workflows aktiviert werden.

- Erweiterungen und MCP -Server tragen dazu bei, maßgeschneiderte Workflows direkt in die CLI- oder IDE -Umgebung zu integrieren und die Produktivität und die Flexibilität der Toolchain zu verbessern.

Zusammenfassung des Prozesses zum Hinzufügen benutzerdefinierter Tools oder Erweiterungen

1. Entscheiden Sie den Umfang des benutzerdefinierten Tools:
Stellen Sie fest, ob es sich um einen einfachen benutzerdefinierten Befehl, ein Skript oder einen vollwertigen externen Dienst handelt.

2. für einfache benutzerdefinierte Befehle:
Erstellen Sie `.toml` -Dateien, die Slash -Befehle definieren, und platzieren Sie sie in den entsprechenden Befehlsordner.

3. für externe Dienste oder komplexe Logik:
Entwickeln Sie einen MCP -Server mit dem MCP SDK (unterstützende Sprachen wie Python oder TypeScript), die die Werkzeugfunktionen über standardisierte API enthüllt.

4. Konfigurieren Sie den MCP -Server in `setts.json` oder Erweiterung:
Fügen Sie den MCP Server-Konfigurationseintrag (mit dem Befehl oder der URL) entweder direkt in der Benutzerkonfiguration `~/.Gemini/Settings.json` oder in einer" Gemini-oxtesion.json "-Datei in einem Erweiterungsverzeichnis hinzu.

5. optional in einer Erweiterung bündeln:
Verpacken Sie Ihre MCP -Server, benutzerdefinierten Befehle und Kontextdateien in eine Erweiterungsverzeichnisstruktur unter `. Gemini/Erweiterungen/`.

6. Start oder Neustart Gemini CLI:
Gemini CLI lädt alle Konfigurationen und MCP-Server auf dem Start, automatisch integrieren benutzerdefinierte Tools.

7. Verwenden und überprüfen Sie Tools:
Verwenden Sie Befehle wie `/mcp` und`/MCP Desc`, um die Verfügbarkeit von Werkzeugen zu bestätigen und mit Ihren benutzerdefinierten Ergänzungen zu interagieren.

Vorteile dieser Architektur

- Modularität: Tools werden als separate MCP -Server ausgeführt, die die Entwicklung unabhängig und skalierbar machen.

.

- Sicherheit und Kontrolle: Erweiterungen können einschränken, welche Werkzeuge oder Shellbefehle zulässig sind und Missbrauch verhindern.

- Wiederverwendbarkeit: Erweiterungspaket Komplette Workflows, die über Projekte oder Teams hinweg geteilt werden können.

- Community und Ökosystem: Viele MCP -Server und -Ertensionen sind verfügbar oder können beigetragen werden, wodurch sich schnell expandierende Gemini -CLI -Fähigkeiten erweitert.

Mit dieser Architektur kann praktisch jedes externe Werkzeug, Skript oder Service in das Gemini -Cli -Ökosystem integriert werden, wodurch die Produktivität und Anpassung gesteigert werden.

***

Diese Antwort enthält eine gründliche Erläuterung der Mechanismen für Gemini CLI Custom Tool und Erweiterungsintegration, einschließlich MCP -Server, Erweiterungsverpackung, benutzerdefinierten Befehlen und Skriptintegration, der Erfüllung der angeforderten Länge und Details. Auf Wunsch können als nächstes weitere Einzelheiten zur MCP -SDK -Nutzung oder beispielhaften Konfigurationen bereitgestellt werden.