Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon Hvordan kan jeg legge til tilpassede verktøy eller utvidelser til Gemini CLI


Hvordan kan jeg legge til tilpassede verktøy eller utvidelser til Gemini CLI


For å legge til tilpassede verktøy eller utvidelser til Gemini CLI, er den primære mekanismen gjennom Model Context Protocol (MCP) og tilpassede utvidelser som Gemini CLI støtter. Nedenfor er en detaljert guide med viktige aspekter og trinn for å legge til tilpassede verktøy eller utvidelser til Gemini CLI:

Utvidelse av Gemini CLI med tilpassede verktøy via MCP

Gemini CLI er designet for å være utvidbar gjennom Model Context Protocol (MCP). MCP fungerer som en standardisert måte å koble eksterne tjenester og muligheter (verktøy) til Gemini CLI. Ved å konfigurere MCP-servere kan Gemini CLI integrere disse eksterne verktøyene sømløst i sin AI-drevne kommando og resonnere arbeidsflyten.

- Sette opp MCP -servere:
Du starter med å konfigurere MCP -servere i Gemini CLI -innstillingsfilen, vanligvis funnet på `~/.gemini/innstillinger.json`. Denne JSON -filen konfigurerer hva MCP -servere skal koble til, inkludert tilkoblingsdetaljer og autentisering om nødvendig.

- Bruke eksisterende eller tilpassede MCP -servere:
Mange eksisterende MCP -servere grensesnitt med populære tjenester som GitHub, Gitlab, Firebase, databaser eller medieproduksjon. For virkelig tilpasset funksjonalitet kan du opprette dine egne MCP -servere ved å bruke MCP SDK tilgjengelig på språk som Python eller TypeScript. Dette tillater å være vert for en hvilken som helst tilpasset logikk eller verktøy som MCP -server.

- Konfigurere MCP -servere:
I `innstillinger.json` -filen er MCP -servere definert med navn, servertyper, tilkoblingskommandoer eller URL -er, symboler for autentisering og eventuelle spesialiserte parametere. Når den er konfigurert, vil Gemini CLI koble seg til disse serverne ved oppstart.

- Oppdagelse og bruk av verktøy:
Etter tilkobling utsetter MCP -serverne verktøy som Gemini CLI automatisk oppdager. Du kan liste og beskrive disse verktøyene med kommandoer som `/MCP` og`/MCP Desc`. AI-agenten integrerer dem deretter innfødt i sin beslutnings- og utførelsesstrøm, og velger verktøy etter behov basert på brukerhjul uten manuell inngrep.

Opprette Gemini CLI -utvidelser

Utover MCP-servere støtter Gemini CLI et konsept på høyere nivå kalt utvidelser, som pakker sammen MCP-servere, kontekstfiler og tilpassede kommandoer for å utvide Gemini CLI-funksjonalitet.

- Utvidelsessted:
Utvidelser kan ligge på to primære steder: `/.gemini/utvidelser/` eller `/.gemini/utvidelser/`. Gemini CLI laster alle utvidelser som finnes på begge stedene ved oppstart, med arbeidsområde-spesifikke utvidelser som overstyrer hjemmekatalogversjoner hvis navnet er konflikter oppstår.

- forlengelsesstruktur:
Hver utvidelse er en katalog oppkalt etter utvidelsen (f.eks. `My-Extension`) som inneholder en konfigurasjonsfil som heter` gemini-extension.json`. Denne JSON inkluderer metadata og serverkonfigurasjoner.

- gemini-extension.json innhold:
Typiske nøkler i denne filen inkluderer:

- `Navn`: Unikt forlengelsesnavn.
- `versjon`: utvidelsesversjon.
- `McPservers`: Et kart over MCP -servere konfigurert av utvidelsen, for eksempel kommandoer for å lansere tilpassede MCP -servere.
- `ContextFilename`: Valgfritt. Navn på kontekstfilen lastet som arbeidsområde kontekst for utvidelsen, er standard for `gemini.md`.
- `ExcUdetOls`: Array Specifying Verktøy eller verktøykommandoer for å ekskludere, nyttige for å blokkere farlige eller uønskede operasjoner.

- Tilpassede kommandoer i utvidelser:
Utvidelser kan gi tilpassede skråstrek -kommandoer ved å plassere `.Toml` -kommandovdefiler i en` -kommandoer/`underkatalog innenfor utvidelseskatalogen. Disse kommandoene er definert på samme måte som bruker- eller prosjektspesifikke kommandoer.

- Slå sammen oppførsel:
Når Gemini CLI starter, fusjonerer den utvidelseskonfigurasjoner med brukerens hovedinnstillinger og innebygde verktøy, og løser konflikter ved å gi arbeidsområde-innstillinger prioritert.

Opprette tilpassede slash -kommandoer med TOML -filer

En fleksibel måte å legge til gjenbrukbare kommandoer (verktøy) er ved å bruke `.toml` -filer som tilpassede skråkommandoer.

- Sted:
Sett Toml-kommandofiler i `~/.gemini/kommandoer/` for globale kommandoer eller i prosjektlokal `. Gemini/kommandoer/` katalog.

- Toml -format:
Disse filene definerer kommandoen, hurtig maler og kan innlemme argumenter med plassholdere som ``. De støtter også utførelse av skallkommando innen ledeteksten ved å bruke syntaks som `! {...}` for å legge inn skripting.

- Bruk:
Disse kommandoene kan påberopes direkte i Gemini CLI gjennom Slash -kommandoer som `/MyCommand`, noe som enkelt muliggjør skriptede arbeidsflyter eller integrasjoner.

Kjører tilpassede python -skript og skallkommandoer

- Siden Gemini CLI støtter kjørende skallkommandoer og skript, kan du utløse tilpassede Python -skript eller andre programmer som en del av MCP -serveren eller tilpassede kommando -arbeidsflytene.

- For eksempel kan et Python-skript som genererer PDF-er fra Gemini CLI-svar, pakkes inn på en MCP-server eller utført som en Shell-kommando i en tilpasset TOML-kommando, noe som muliggjør arbeidsflyter med en kommando.

Integrering med IDE -er og miljø

- Gemini CLI-utvidelser kan også forbedre integrasjonen med IDE-er som VS-kode ved å dele arbeidsområde-kontekst (filer, markørplassering, valg), muliggjøre AI-drevet kodehjelp arbeidsflyter.

- Utvidelser og MCP -servere hjelper til med å integrere skreddersydde arbeidsflyter direkte i CLI- eller IDE -miljøet, og forbedrer produktiviteten og verktøykjedens fleksibilitet.

Sammendrag av prosessen for å legge til tilpassede verktøy eller utvidelser

1. Bestem omfanget av tilpasset verktøy:
Bestem om det er en enkel tilpasset kommando, et skript eller en fullverdig ekstern tjeneste.

2. For enkle tilpassede kommandoer:
Lag `.toml` -filer som definerer skråstrek -kommandoer og plasserer dem i den aktuelle kommando -mappen.

3. For eksterne tjenester eller kompleks logikk:
Utvikle en MCP -server ved hjelp av MCP SDK (støttende språk som Python eller TypeScript) som avslører verktøyfunksjonene via standardisert API.

4. Konfigurer MCP -server i `innstillinger.json` eller utvidelse:
Legg til MCP-serverkonfigurasjonsoppføringen (med kommando eller URL) enten direkte i brukerkonfigurasjonen `~/.gemini/innstillinger.json` eller inne i en` gemini-extension.json`-fil i en utvidelseskatalog.

5. Eventuelt pakke i en utvidelse:
Pakk MCP -servere, tilpassede kommandoer og kontekstfiler til en utvidelseskatalogstruktur under `. Gemini/Extensions/`.

6. Start eller start Gemini CLI:
Gemini CLI laster alle konfigurasjoner og MCP-servere ved oppstart, automatisk integrerende tilpassede verktøy.

7. Bruk og bekreft verktøy:
Bruk kommandoer som `/MCP` og`/MCP Desc` for å bekrefte tilgjengeligheten av verktøyet og samhandle med dine tilpassede tillegg.

fordeler med denne arkitekturen

- Modularitet: Verktøy kjøres som separate MCP -servere, noe som gjør utvikling uavhengig og skalerbar.

- Dynamisk integrasjon: Verktøy vises automatisk i Gemini CLI -arbeidsflyter uten hardkoding.

- Sikkerhet og kontroll: Utvidelser kan begrense hvilke verktøy eller skallkommandoer som er tillatt, og forhindrer misbruk.

- Gjenbrukbarhet: Extensions Pakke komplette arbeidsflyter, deles på tvers av prosjekter eller team.

- Fellesskap og økosystem: Mange MCP -servere og utvidelser er tilgjengelige eller kan bidra, og utvidet raskt Gemini CLI -funksjoner.

Denne arkitekturen lar praktisk talt ethvert eksternt verktøy, skript eller tjeneste integreres i Gemini CLI -økosystemet, noe som øker produktiviteten og tilpasningen.

***

Dette svaret gir en grundig forklaring av Gemini CLI tilpassede verktøy og utvidelsesintegrasjonsmekanismer, inkludert MCP -servere, utvidelsesemballasje, tilpassede kommandoer og skriptintegrasjon, som oppfyller lengden og detaljene som ble bedt om. Om ønskelig kan det gis mer detaljer om MCP SDK -bruk eller eksempler på konfigurasjoner.

All informasjon er basert på autoritativ Gemini CLI -dokumentasjon og samfunnskilder tilgjengelig fra september 2025.