Hoe kan ik aangepaste tools of extensies toevoegen aan Gemini CLI

Gemini CLI uitbreiden met aangepaste tools via MCP

Gemini CLI is ontworpen om te worden uitgebreid via het Model Context Protocol (MCP). MCP fungeert als een gestandaardiseerde manier om externe services en mogelijkheden (tools) te verbinden met Gemini CLI. Door MCP-servers te configureren, kan Gemini CLI deze externe tools naadloos integreren in zijn AI-aangedreven opdracht en redeneerworkflow.

- MCP -servers opzetten:
U begint met het configureren van MCP -servers in het Gemini CLI -instellingenbestand, meestal te vinden op `~/.gemini/settings.json`. Dit JSON -bestand configureert met wat MCP -servers om mee te verbinden, inclusief verbindingsdetails en authenticatie indien nodig.

- Gebruik van bestaande of aangepaste MCP -servers:
Veel bestaande MCP -servers interface met populaire services zoals GitHub, GitLab, Firebase, databases of media -generatie. Voor echt aangepaste functionaliteit kunt u uw eigen MCP -servers maken met behulp van de MCP SDK die beschikbaar is in talen zoals Python of Typescript. Hierdoor kan het hosten van elke aangepaste logica of tool als MCP -server.

- MCP -servers configureren:
In het bestand `settings.json` worden MCP -servers gedefinieerd met hun namen, servertypen, verbindingsopdrachten of URL's, tokens voor authenticatie en gespecialiseerde parameters. Eenmaal geconfigureerd, zal Gemini CLI bij het opstarten verbinding maken met deze servers.

- Ontdekking en gebruik van tools:
Na verbinding stellen de MCP -servers hulpmiddelen bloot die Gemini CLI automatisch ontdekt. U kunt deze tools vermelden en beschrijven met opdrachten zoals `/mcp` en`/mcp desc`. De AI-agent integreert ze vervolgens native in zijn besluitvormings- en uitvoeringsstroom en selecteert tools indien nodig op basis van gebruikersprompts zonder handmatige interventie.

Gemini CLI -extensies maken

Naast MCP-servers ondersteunt Gemini CLI een concept op een hoger niveau genaamd extensions, die MCP-servers, contextbestanden en aangepaste opdrachten samenvoegen om Gemini CLI-functionaliteit uit te breiden.

- Extensielocatie:
Extensies kunnen op twee primaire locaties verblijven: `/.Gemini/extensions/` of `/.Gemini/extensions/`. Gemini CLI laadt alle extensies die op beide locaties op het opstarten worden gevonden, met werkruimtespecifieke extensies die de thuismap-versies overschrijden als naamconflicten ontstaan.

- Uitbreidingstructuur:
Elke extensie is een directory die naar de extensie wordt genoemd (bijv. `My-extension ') die een configuratiebestand bevat met de naam' Gemini-extension.json '. Deze JSON bevat metadata- en serverconfiguraties.

- Gemini-extension.json content:
Typische toetsen in dit bestand zijn onder meer:

- `name`: unieke uitbreidingsnaam.
- `Versie`: Extension -versie.
- `MCPSERVERS`: Een kaart van MCP -servers geconfigureerd door de extensie, bijvoorbeeld opdrachten om aangepaste MCP -servers te starten.
- `contextfilename`: optioneel. Naam van contextbestand geladen als werkruimtecontext voor de extensie, standaard van `Gemini.md`.
- `ExcluDetools`: Array specificerende tools of toolopdrachten om uit te sluiten, nuttig voor het blokkeren van gevaarlijke of ongewenste bewerkingen.

- Aangepaste opdrachten in extensies:
Extensies kunnen aangepaste slash -opdrachten bieden door `.toml` opdrachtdefinitiebestanden te plaatsen in een` opdrachten/`subdirectory in de extensiemap. Deze opdrachten worden op dezelfde manier gedefinieerd als gebruikers- of projectspecifieke opdrachten.

- Gedrag samenvoegen:
Wanneer Gemini CLI begint, gaat het uitbreidingsconfiguraties samen met de belangrijkste instellingen van de gebruiker en ingebouwde tools, waardoor conflicten worden opgelost door de prioriteit van de werkruimte-instellingen te geven.

Custom Slash -opdrachten maken met Toml -bestanden

Een flexibele manier om herbruikbare opdrachten (tools) toe te voegen, is door '.toml' -bestanden te gebruiken als aangepaste slash -opdrachten.

- Locatie:
Plaats toml-opdrachtbestanden in `~/.gemini/commands/` voor globale opdrachten of in de projectlocal `.gemini/opdrachten/` Directory.

- Toml -formaat:
Deze bestanden definiëren de opdracht, snelle sjablonen en kunnen argumenten opnemen met tijdelijke aanduidingen zoals ``. Ze ondersteunen ook de uitvoering van de shell -opdracht binnen de prompt met syntaxis zoals `! {...}` om scripting in te sluiten.

- Gebruik:
Deze opdrachten kunnen rechtstreeks in Gemini CLI worden ingeroepen via slash -opdrachten zoals `/myCommand`, waardoor script workflows of integraties eenvoudig mogelijk worden gemaakt.

met aangepaste python scripts en shell -opdrachten

- Aangezien Gemini CLI het uitvoeren van shell -opdrachten en scripts ondersteunt, kunt u aangepaste Python -scripts of andere programma's activeren als onderdeel van uw MCP -server of aangepaste opdrachtworkflows.

- Een Python-script die PDF's genereert uit Gemini CLI-antwoorden kan worden gewikkeld in een MCP-server of worden uitgevoerd als een shell-opdracht in een aangepaste TOML-opdracht, waardoor workflows met één commando genereren.

Integratie met IDE's en omgeving

- Gemini CLI-extensies kunnen ook de integratie met IDE's zoals VS-code verbeteren door de context van de werkruimte te delen (bestanden, cursorlocatie, selecties), waardoor AI-aangedreven codehulp workflows mogelijk is.

- Extensies en MCP -servers helpen bij het integreren van workflows op maat direct in de CLI- of IDE -omgeving, waardoor de productiviteit en de flexibiliteit van de toolchain wordt verbeterd.

Samenvatting van het proces om aangepaste tools of extensies toe te voegen

1. Bepaal de reikwijdte van de aangepaste tool:
Bepaal of het een eenvoudige aangepaste opdracht, een script of een volwaardige externe service is.

2. Voor eenvoudige aangepaste opdrachten:
Maak `.toml` -bestanden die schuine bevelen definiëren en plaats ze in de juiste map Opdrachten.

3. Voor externe services of complexe logica:
Ontwikkel een MCP -server met behulp van de MCP SDK (ondersteunende talen zoals Python of Typescript) die de toolmogelijkheden blootlegt via gestandaardiseerde API.

4. Configureer MCP -server in `settings.json` of extensie:
Voeg de MCP-serverconfiguratie-invoer toe (met opdracht of URL) rechtstreeks in de gebruikersconfiguratie `~/.gemini/settings.json` of in een` gemini-extension.json`-bestand in een extensiemap.

5. Optioneel bundelen in een extensie:
Pak uw MCP -servers, aangepaste opdrachten en contextbestanden in een extensiemapstructuur onder `.Gemini/extensions/`.

6. Start of herstart Gemini CLI:
Gemini CLI laadt alle configuraties en MCP-servers bij het opstarten, met automatische integratie van aangepaste tools.

7. Gebruik en verifieer tools:
Gebruik opdrachten zoals `/mcp` en`/mcp desc` om de beschikbaarheid van tools te bevestigen en te communiceren met uw aangepaste toevoegingen.

Voordelen van deze architectuur

- Modulariteit: tools worden uitgevoerd als afzonderlijke MCP -servers, waardoor ontwikkeling onafhankelijk en schaalbaar wordt.

- Dynamische integratie: tools verschijnen automatisch in Gemini CLI -workflows zonder hardcodering.

- Beveiliging en controle: extensies kunnen beperken welke tools of shell -opdrachten zijn toegestaan, waardoor misbruik wordt voorkomen.

- Herbruikbaarheid: extensiespakket complete workflows, deelbaar tussen projecten of teams.

- Gemeenschap en ecosysteem: veel MCP -servers en extensies zijn beschikbaar of kunnen worden bijgedragen, waardoor de Gemini CLI -mogelijkheden snel uitbreiden.

Met deze architectuur kan vrijwel elke externe tool, script of service worden geïntegreerd in het Gemini CLI -ecosysteem, waardoor de productiviteit en -aanpassing worden verhoogd.

***

Dit antwoord biedt een grondige uitleg van Gemini CLI Custom Tool en Extension Integration -mechanismen, waaronder MCP -servers, uitbreidingsverpakkingen, aangepaste opdrachten en scripting -integratie, die voldoen aan de gevraagde lengte en details. Indien gewenst, kunnen vervolgens meer details over MCP SDK -gebruik of voorbeeldconfiguraties worden verstrekt.