Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon Hvordan kan jeg tilføje tilpassede værktøjer eller udvidelser til Gemini CLI


Hvordan kan jeg tilføje tilpassede værktøjer eller udvidelser til Gemini CLI


For at tilføje brugerdefinerede værktøjer eller udvidelser til Gemini CLI er den primære mekanisme gennem Model Context Protocol (MCP) og brugerdefinerede udvidelser, som Gemini CLI understøtter. Nedenfor er en detaljeret guide med centrale aspekter og trin til tilføjelse af brugerdefinerede værktøjer eller udvidelser til Gemini CLI:

Udvidelse af Gemini CLI med brugerdefinerede værktøjer via MCP

Gemini CLI er designet til at være udvidelig gennem Model Context Protocol (MCP). MCP fungerer som en standardiseret måde at forbinde eksterne tjenester og kapaciteter (værktøjer) til Gemini CLI. Ved at konfigurere MCP-servere kan Gemini CLI integrere disse eksterne værktøjer problemfrit i sin AI-drevne kommando og ræsonnement arbejdsgang.

- Opsætning af MCP -servere:
Du starter med at konfigurere MCP -servere i Gemini CLI -indstillingsfilen, der typisk findes på `~/.gemini/Settings.json`. Denne JSON -fil konfigurerer, hvad MCP -servere skal oprette forbindelse til, inklusive forbindelsesoplysninger og godkendelse om nødvendigt.

- Brug af eksisterende eller brugerdefinerede MCP -servere:
Mange eksisterende MCP -servere interface med populære tjenester som Github, Gitlab, Firebase, Databases eller Media Generation. For virkelig tilpasset funktionalitet kan du oprette dine egne MCP -servere ved hjælp af MCP SDK, der er tilgængelig på sprog som Python eller TypeScript. Dette tillader at være vært for enhver brugerdefineret logik eller værktøj som en MCP -server.

- Konfiguration af MCP -servere:
I filen 'Settings.json` defineres MCP -servere med deres navne, servertyper, forbindelseskommandoer eller URL'er, symboler til godkendelse og eventuelle specialiserede parametre. Når Gemini CLI først er konfigureret, opretter forbindelse til disse servere ved opstart.

- Opdagelse og brug af værktøjer:
Efter forbindelse afslører MCP -serverne værktøjer, som Gemini CLI automatisk opdager. Du kan liste og beskrive disse værktøjer med kommandoer som `/mcp` og`/mcp desc`. AI-agenten integrerer dem derefter naturligt i sin beslutningstagning og udførelsesstrøm, der vælger værktøjer efter behov baseret på brugeroptagelser uden manuel indgriben.

Oprettelse af Gemini CLI -udvidelser

Ud over MCP-servere understøtter Gemini CLI et koncept på højere niveau kaldet Extensions, der bundter MCP-servere, kontekstfiler og brugerdefinerede kommandoer for at udvide Gemini CLI-funktionalitet.

- Udvidelsesplacering:
Udvidelser kan opholde sig på to primære placeringer: `/.gemini/udvidelser/` eller `/.gemini/udvidelser/`. Gemini CLI indlæser alle udvidelser, der findes begge steder ved opstart, med arbejdsområde-specifikke udvidelser, der overstiger hjemmebeskyttelsesversioner, hvis der opstår navnekonflikter.

- Udvidelsesstruktur:
Hver udvidelse er et bibliotek opkaldt efter udvidelsen (f.eks. 'My-extension'), der indeholder en konfigurationsfil med navnet `gemini-extension.json`. Denne JSON inkluderer metadata og serverkonfigurationer.

- Gemini-extension.json indhold:
Typiske nøgler i denne fil inkluderer:

- `Navn`: Unikt udvidelsesnavn.
- `version`: Extension Version.
- `McPservers`: Et kort over MCP -servere, der er konfigureret af udvidelsen, f.eks. Kommandoer til at starte brugerdefinerede MCP -servere.
- `ContextFileName`: Valgfrit. Navn på kontekstfil indlæst som arbejdsområde -kontekst for udvidelsen, som standard til `gemini.md`.
- `Ekskluderetools`: Array, der specificerer værktøjer eller værktøjskommandoer til at udelukke, nyttige til at blokere farlige eller uønskede operationer.

- Brugerdefinerede kommandoer i udvidelser:
Udvidelser kan give brugerdefinerede skråstregskommandoer ved at placere `.toml` kommandodefinitionsfiler inde i en` kommandoer/`undermappen i udvidelsesmappen. Disse kommandoer er defineret på samme måde som bruger- eller projektspecifikke kommandoer.

- Merge opførsel:
Når Gemini CLI starter, fusionerer den udvidelseskonfigurationer med brugerens vigtigste indstillinger og indbyggede værktøjer, der løser konflikter ved at give arbejdsområdeindstillinger prioritet.

Oprettelse af brugerdefinerede skråstregskommandoer med TOML -filer

En fleksibel måde at tilføje genanvendelige kommandoer (værktøjer) på er ved at bruge `.toml` -filer som brugerdefinerede skråstregskommandoer.

- Placering:
Sæt Toml-kommandofiler i `~/.gemini/kommandoer/` for globale kommandoer eller i det projekt-lokale `.gemini/kommandoer/` bibliotek.

- Toml -format:
Disse filer definerer kommandoen, hurtige skabeloner og kan inkorporere argumenter med pladsholdere som ``. De understøtter også shell -kommandoudførelse inden for prompten ved hjælp af syntaks som `! {...}` til indlejring af scripting.

- Brug:
Disse kommandoer kan påberåbes direkte i Gemini CLI gennem skråstregskommandoer som `/MyCommand`, hvilket muliggør scriptede arbejdsgange eller integrationer let.

kører brugerdefinerede Python -scripts og shell -kommandoer

- Da Gemini CLI understøtter at køre shell -kommandoer og scripts, kan du udløse brugerdefinerede Python -scripts eller andre programmer som en del af din MCP -server eller brugerdefinerede kommando -arbejdsgange.

- For eksempel kunne et Python-script, der genererer PDF'er fra Gemini CLI-svar, indpakkes i en MCP-server eller udføres som en shell-kommando i en brugerdefineret TOML-kommando, der muliggør arbejdsgange med en kommando.

Integration med IDE'er og miljø

- Gemini CLI-udvidelser kan også forbedre integrationen med IDE'er som VS-kode ved at dele arbejdsområde-kontekst (filer, markørplacering, valg), hvilket muliggør AI-drevet kodeassistent arbejdsgange.

- Udvidelser og MCP -servere hjælper med at integrere skræddersyede arbejdsgange direkte i CLI- eller IDE -miljøet, hvilket forbedrer produktiviteten og værktøjskæskens fleksibilitet.

Resumé af processen for at tilføje brugerdefinerede værktøjer eller udvidelser

1. Bestem omfanget af brugerdefineret værktøj:
Bestem, om det er en simpel brugerdefineret kommando, et script eller en fuldt udbygget ekstern service.

2. For enkle brugerdefinerede kommandoer:
Opret `.toml` -filer, der definerer skråstregskommandoer, og placer dem i mappen relevant kommandoer.

3. for eksterne tjenester eller kompleks logik:
Udvikle en MCP -server ved hjælp af MCP SDK (understøttende sprog som Python eller TypeScript), der afslører værktøjsfunktionerne via standardiseret API.

4. Konfigurer MCP -server i `Settings.json` eller udvidelse:
Tilføj MCP-serverkonfigurationsindgangen (med kommando eller URL) enten direkte i brugerkonfigurationen `~/.gemini/Settings.json` eller inde i en` gemini-extension.json`-fil inden for et udvidelsesmappe.

5. Valgfrit bundt i en udvidelse:
Pakk dine MCP -servere, brugerdefinerede kommandoer og kontekstfiler i en udvidelsesmappestruktur under `.gemini/udvidelser/`.

6. Start eller genstart Gemini CLI:
Gemini CLI indlæser alle konfigurationer og MCP-servere ved opstart, auto-integrerende brugerdefinerede værktøjer.

7. Brug og bekræft værktøjer:
Brug kommandoer som `/mcp` og`/mcp desc` til at bekræfte værktøjets tilgængelighed og interagere med dine brugerdefinerede tilføjelser.

Fordele ved denne arkitektur

- Modularitet: Værktøjer kører som separate MCP -servere, hvilket gør udviklingen uafhængig og skalerbar.

- Dynamisk integration: Værktøjer vises automatisk i Gemini CLI -arbejdsgange uden hardkodning.

- Sikkerhed og kontrol: Udvidelser kan begrænse hvilke værktøjer eller shell -kommandoer, der er tilladt, hvilket forhindrer misbrug.

- Genanvendelighed: Extensions -pakke komplette arbejdsgange, delbar på tværs af projekter eller teams.

- Fællesskab og økosystem: Mange MCP -servere og udvidelser er tilgængelige eller kan bidrage, hvilket hurtigt ekspanderer Gemini CLI -kapaciteter.

Denne arkitektur tillader stort set ethvert eksternt værktøj, script eller service at blive integreret i Gemini CLI -økosystemet, hvilket øger produktiviteten og tilpasningen.

***

Dette svar giver en grundig forklaring af Gemini CLI Custom Tool og Extension Integration -mekanismer, herunder MCP -servere, udvidelsesemballage, brugerdefinerede kommandoer og scripting -integration, opfylder den ønskede længde og detalje. Hvis det ønskes, kan der leveres flere detaljer om MCP SDK -brug eller eksempelkonfigurationer næste.

Al information er baseret på autoritativ Gemini CLI -dokumentation og samfundskilder tilgængelige fra september 2025.