Hur kan jag lägga till anpassade verktyg eller tillägg till Gemini CLI

Utöka Gemini CLI med anpassade verktyg via MCP

Gemini CLI är utformat för att vara utdragbar genom Model Context Protocol (MCP). MCP fungerar som ett standardiserat sätt att ansluta externa tjänster och kapacitet (verktyg) till Gemini CLI. Genom att konfigurera MCP-servrar kan Gemini CLI integrera dessa externa verktyg sömlöst i sitt AI-drivna kommando och resonemangsarbetsflöde.

- Ställa in MCP -servrar:
Du börjar med att konfigurera MCP -servrar i Gemini CLI -inställningsfilen, vanligtvis finns på `~/.gemini/inställningar.json`. Den här JSON -filen konfigurerar vad MCP -servrar ska ansluta till, inklusive anslutningsinformation och autentisering om det behövs.

- Använda befintliga eller anpassade MCP -servrar:
Många befintliga MCP -servrar gränssnitt med populära tjänster som GitHub, Gitlab, Firebase, databaser eller medieproduktion. För verkligen anpassad funktionalitet kan du skapa dina egna MCP -servrar med MCP SDK som finns på språk som Python eller TypeScript. Detta gör att värd för alla anpassade logik eller verktyg som MCP -server.

- Konfigurera MCP -servrar:
I filen "Inställningar.json" definieras MCP -servrar med deras namn, servertyper, anslutningskommandon eller webbadresser, tokens för autentisering och eventuella specialiserade parametrar. När den har konfigurerats kommer Gemini CLI att ansluta till dessa servrar vid start.

- Upptäckt och användning av verktyg:
Efter anslutningen exponerar MCP -servrarna verktyg som Gemini CLI automatiskt upptäcker. Du kan lista och beskriva dessa verktyg med kommandon som `/mcp` och`/mcp desc`. AI-agenten integrerar dem sedan naturligt i sitt beslutsfattande och exekveringsflöde och väljer verktyg efter behov baserat på användaruppdrag utan manuell ingripande.

Skapa Gemini CLI -tillägg

Utöver MCP-servrar stöder Gemini CLI ett koncept på högre nivå som kallas Extensions, som samlar MCP-servrar, kontextfiler och anpassade kommandon för att utöka Gemini CLI-funktionalitet.

- Förlängningsplats:
Förlängningar kan finnas på två primära platser: `/.gemini/tillägg/` eller `/.gemini/tillägg/`. Gemini CLI laddar alla tillägg som finns på båda platserna vid start, med arbetsyta-specifika tillägg som åsidosätter hemkatalogversioner om namnkonflikter uppstår.

- Förlängningsstruktur:
Varje tillägg är en katalog uppkallad efter tillägget (t.ex. `My-Extension ') som innehåller en konfigurationsfil med namnet` Gemini-extension.json'. Denna JSON inkluderar metadata och serverkonfigurationer.

- Gemini-extension.json Innehåll:
Typiska nycklar i den här filen inkluderar:

- `namn ': unikt förlängningsnamn.
- `Version`: Extension -version.
- `MCPSERVERS`: En karta över MCP -servrar konfigurerade av tillägget, t.ex. kommandon för att starta anpassade MCP -servrar.
- `ContextFileName`: Valfritt. Namn på sammanhangsfilen laddad som arbetsytans sammanhang för förlängningen, standard till `Gemini.md`.
- `ExcludeTools`: Array Ange verktyg eller verktygskommandon för att utesluta, användbara för att blockera farliga eller oönskade operationer.

- Anpassade kommandon i tillägg:
Tillägg kan tillhandahålla anpassade SLASH -kommandon genom att placera kommandofiler för ".Toml" i en "kommandon/" underkatalog i förlängningskatalogen. Dessa kommandon definieras på samma sätt som användar- eller projektspecifika kommandon.

- Slå samman beteende:
När Gemini CLI startar, slås det samman förlängningskonfigurationerna med användarens huvudinställningar och inbyggda verktyg, vilket löser konflikter genom att prioritera arbetsytan.

Skapa anpassade snedstreckkommandon med TOML -filer

Ett flexibelt sätt att lägga till återanvändbara kommandon (verktyg) är att använda ".Toml" -filer som anpassade snedstreckkommandon.

- Plats:
Sätt TOML-kommandofiler i `~/.gemini/kommandon/` för globala kommandon eller i projekt-lokala `.gemini/kommandon/` katalog.

- Toml -format:
Dessa filer definierar kommandot, snabba mallar och kan innehålla argument med platshållare som ``. De stöder också exekvering av skalkommandot inom prompten med syntax som `! {...}` för att bädda in skript.

- Användning:
Dessa kommandon kan åberopas direkt i Gemini CLI via snedstreckkommandon som `/myCommand`, vilket möjliggör enkelt arbetsflöden eller integrationer.

Kör anpassade pythonskript och skalkommandon

- Eftersom Gemini CLI stöder körskalkommandon och skript kan du utlösa anpassade Python -skript eller andra program som en del av din MCP -server eller anpassade kommando -arbetsflöden.

- Till exempel kan ett Python-skript som genererar PDF-filer från Gemini CLI-svar förpackas på en MCP-server eller köras som ett skalkommando i ett anpassat TOML-kommando, vilket möjliggör en befälhavande genereringsarbetsflöden.

Integration med IDE och miljö

- Gemini CLI-tillägg kan också förbättra integrationen med IDE: er som VS-kod genom att dela Workspace Context (filer, markörplats, val), vilket möjliggör arbetsflöden för AI-driven kodhjälp.

- Extensions och MCP -servrar hjälper till att integrera skräddarsydda arbetsflöden direkt i CLI- eller IDE -miljön, vilket förbättrar produktiviteten och verktygskedjan.

Sammanfattning av processen för att lägga till anpassade verktyg eller tillägg

1. Bestäm omfattningen av anpassat verktyg:
Bestäm om det är ett enkelt anpassat kommando, ett skript eller en fullfjädrad extern tjänst.

2. För enkla anpassade kommandon:
Skapa ".Toml" -filer som definierar snedstreckkommandon och placera dem i lämpliga kommandonmappen.

3. För externa tjänster eller komplex logik:
Utveckla en MCP -server med MCP SDK (stödjande språk som Python eller TypeScript) som exponerar verktygsfunktionerna via standardiserat API.

4. Konfigurera MCP -server i `inställningar.json` eller förlängning:
Lägg till MCP-serverkonfigurationsposten (med kommando eller URL) antingen direkt i användarkonfigurationen `~/.gemini/inställningar.json` eller inuti en" Gemini-extension.json "-fil i en förlängningskatalog.

5. Bunt i en förlängning:
Packa dina MCP -servrar, anpassade kommandon och kontextfiler till en förlängningskatalogstruktur under `.Gemini/Extensions/`.

6. Starta eller starta om Gemini CLI:
Gemini CLI laddar alla konfigurationer och MCP-servrar vid start, autointegrerande anpassade verktyg.

7. Använd och verifiera verktyg:
Använd kommandon som `/mcp` och`/mcp desc` för att bekräfta verktygstillgänglighet och interagera med dina anpassade tillägg.

Fördelar med denna arkitektur

- Modularitet: Verktyg körs som separata MCP -servrar, vilket gör utveckling oberoende och skalbar.

- Dynamisk integration: Verktyg visas automatiskt i Gemini CLI -arbetsflöden utan hårdkodning.

- Säkerhet och kontroll: Tillägg kan begränsa vilka verktyg eller skalkommandon som är tillåtna, vilket förhindrar missbruk.

- Återanvändbarhet: Extensionspaket kompletta arbetsflöden, delbara över projekt eller team.

- Gemenskap och ekosystem: Många MCP -servrar och tillägg finns tillgängliga eller kan bidra, snabbt expanderande Gemini CLI -kapacitet.

Denna arkitektur tillåter praktiskt taget alla externa verktyg, skript eller tjänster att integreras i Gemini CLI -ekosystemet, vilket ökar produktiviteten och anpassningen.

***

Detta svar ger en grundlig förklaring av Gemini CLI Custom Tool och förlängningsintegrationsmekanismer, inklusive MCP -servrar, förlängningsförpackningar, anpassade kommandon och skriptintegration, uppfyller den begärda längden och detalj. Om så önskas kan mer detaljer om MCP SDK -användning eller exempelkonfigurationer tillhandahållas nästa.