Mukautettujen työkalujen tai laajennusten lisäämiseksi Gemini CLI: hen ensisijainen mekanismi tapahtuu malliyhteysprotokollan (MCP) ja räätälöityjen laajennusten kautta, joita Gemini CLI tukee. Alla on yksityiskohtainen opas, jolla on keskeiset näkökohdat ja vaiheet mukautettujen työkalujen tai laajennusten lisäämiseksi Gemini CLI: lle:
Gemini CLI: n laajentaminen mukautetuilla työkaluilla MCP: n kautta
Gemini CLI on suunniteltu laajennettaviksi malliyhteysprotokollan (MCP) kautta. MCP toimii standardisoiduna tapana yhdistää ulkoiset palvelut ja ominaisuudet (työkalut) Gemini CLI: hen. Määrittämällä MCP-palvelimet, Gemini CLI voi integroida nämä ulkoiset työkalut saumattomasti AI-ohjattuun komentoonsa ja perustella työnkulkua.
- MCP -palvelimien asettaminen:
Aloitat määrittämällä MCP -palvelimet Gemini CLI -asetustiedostossa, joka on tyypillisesti `~/.gemini/setings.json`. Tämä JSON -tiedosto määrittää, mihin MCP -palvelimiin on muodostettava yhteys, mukaan lukien yhteystiedot ja todennus tarvittaessa.
- Nykyisten tai mukautettujen MCP -palvelimien käyttäminen:
Monet olemassa olevat MCP -palvelimet liittyvät suosittuihin palveluihin, kuten GitHub, Gitlab, Firebase, tietokanta tai tiedotusvälineiden luominen. Todella räätälöityjen toimintojen saavuttamiseksi voit luoda omat MCP -palvelimet käyttämällä MCP SDK: ta saatavana kielillä, kuten Python tai TypeScript. Tämä mahdollistaa minkä tahansa mukautetun logiikan tai työkalun isännöinnin MCP -palvelimena.
- MCP -palvelimien määrittäminen:
"Asetukset.json` -tiedostossa MCP -palvelimet määritetään nimillä, palvelintyypeillä, yhteyskomennoilla tai URL -osoitteilla, todentuneilla ja mahdollisilla erikoistuneilla parametreilla. Kun Gemini CLI on konfiguroitu, se muodostaa yhteyden näihin palvelimiin käynnistyksen yhteydessä.
- Työkalujen löytäminen ja käyttö:
Yhteyden jälkeen MCP -palvelimet paljastavat työkalut, jotka Gemini CLI havaitsee automaattisesti. Voit luetteloida ja kuvata näitä työkaluja komentoilla, kuten `/MCP` ja`/MCP DESC`. Sitten AI-agentti integroi ne alkuperäisesti päätöksentekoon ja suoritusvirtaan valitsemalla työkalut tarvittaessa käyttäjän kehotusten perusteella ilman manuaalista interventiota.
Gemini Cli -laajennusten luominen
MCP-palvelimien lisäksi Gemini CLI tukee korkeamman tason käsitettä, nimeltään Extensions, jotka yhdistävät MCP-palvelimet, kontekstitiedostot ja mukautetut komennot Gemini CLI: n toiminnallisuuden laajentamiseksi.
- Laajennuspaikka:
Laajennukset voivat sijaita kahdessa ensisijaisessa paikassa: `/.gemini/Extensions/` tai `/.gemini/Extensions/`. Gemini CLI kuormittaa kaikki pidennykset, jotka löytyvät molemmista sijainneista käynnistyksessä, työtilakohtaiset laajennukset ohittavat kotihakemistoversiot, jos nimikonfliktit syntyvät.
- Laajennusrakenne:
Jokainen laajennus on hakemisto, joka on nimetty laajennuksen mukaan (esim. `My-Extension`), joka sisältää kokoonpanotiedoston nimeltä` gemini-extension.json`. Tämä JSON sisältää metatiedot ja palvelinkokoonpanot.
- Gemini-Extension.json-sisältö:
Tämän tiedoston tyypilliset avaimet sisältävät:
- `Nimi`: Yksilöllinen laajennuksen nimi.
- `Version`: Laajennusversio.
- `McPservers`: Laajennuksen määrittämät MCP -palvelimien kartta, esim. Komennot käynnistää mukautetut MCP -palvelimet.
- `contextFileName`: Valinnainen. Kontekstitiedoston nimi ladataan laajennuksen työtilan kontekstiksi, oletusarvoisesti `gemini.md`.
- `` sulje poispäin ": taulukko määritetään työkalujen tai työkalujen komentojen sulkemiseksi, jotka ovat hyödyllisiä vaarallisten tai ei -toivottujen toimintojen estämiseksi.
- Mukautetut komennot laajennuksissa:
Laajennukset voivat tarjota mukautettuja viivakomentoja asettamalla `.toml` -komennon määritelmätiedostot` komentojen/`alihakemistoon laajennushakemistossa. Nämä komennot on määritelty samalla tavalla kuin käyttäjä- tai projektikohtaiset komennot.
- Yhdistä käyttäytyminen:
Kun Gemini CLI alkaa, se yhdistää laajennuskokoonpanot käyttäjän pääasetuksiin ja sisäänrakennetuihin työkaluihin, ratkaisemalla konfliktit antamalla työtilan asetukset prioriteetin.
Mukautettujen viivakomentojen luominen TOML -tiedostoilla
Joustava tapa lisätä uudelleenkäytettäviä komentoja (työkalut) on käyttämällä `.toml` -tiedostoja mukautettuina viivakomennoina.
- Sijainti:
Laita Toml-komentotiedostot `~/.gemini/komennot/` globaaleille komentoille tai projekti-paikallisiin `.gemini/komentoihin/` hakemistoon.
- Toml -muoto:
Nämä tiedostot määrittelevät komennon, nopeat mallit ja voivat sisällyttää argumentteja paikkamerkkien kanssa, kuten `
- Käyttö:
Näitä komentoja voidaan kutsua suoraan Gemini CLI: hen viivakomentojen, kuten `/myCommand`, avulla, mahdollistaen käsikirjoitetut työnkulut tai integraatiot helposti.
Mukautettujen python -skriptien ja kuorikomentojen suorittaminen
- Koska Gemini CLI tukee Shell -komentoja ja skriptejä, voit laukaista mukautettuja Python -skriptejä tai muita ohjelmia osana MCP -palvelinta tai mukautettuja komentojen työnkulkuja.
- Esimerkiksi Python-komentosarja, joka tuottaa Gemini CLI -vastauksista peräisin olevia PDF-tiedostoja, voitaisiin kääriä MCP-palvelimeen tai suorittaa kuorikomennona mukautetussa TOML-komennossa, ottaen käyttöön yhden komennon sukupolven työnkulut.
Integraatio IDE: iin ja ympäristöön
- Gemini CLI -laajennukset voivat myös parantaa integrointia IDE: iin, kuten VS-koodiin, jakamalla Workspace-konteksti (tiedostot, kohdistimen sijainti, valinnat), mahdollistamalla AI-pohjaisen koodiapuun.
- Laajennukset ja MCP -palvelimet auttavat integroimaan räätälöityjä työnkulkuja suoraan CLI- tai IDE -ympäristöön parantamalla tuottavuutta ja työkaluketjujen joustavuutta.
Yhteenveto prosessista lisätä mukautettuja työkaluja tai laajennuksia
1. Päätä mukautetun työkalun laajuus:
Selvitä, onko se yksinkertainen mukautettu komento, komentosarja vai täysin fildoitu ulkoinen palvelu.
2. Yksinkertaisten mukautettujen komentojen saamiseksi:
Luo `.toml` tiedostot, jotka määrittelevät viivakomennot ja aseta ne asianmukaisiin komentokansioon.
3. ulkoisille palveluille tai monimutkaiselle logiikasta:
Kehitä MCP -palvelin MCP SDK: n avulla (tukevat kieliä, kuten Python tai TypeScript), joka paljastaa työkaluominaisuudet standardisoidun sovellusliittymän kautta.
4
Lisää MCP-palvelimen kokoonpano (komennolla tai URL-osoitteella) joko suoraan käyttäjän kokoonpanoon `~/.gemini/setings.json` tai` gemini-extension.json` -tiedoston sisään laajennushakemistossa.
5. valinnaisesti niputa laajennuksessa:
Pakkaa MCP -palvelimet, mukautetut komennot ja kontekstitiedostot laajennushakemistorakenteeseen `.Gemini/Extensions/`.
6. Aloita tai käynnistä Gemini Cli:
Gemini CLI lataa kaikki kokoonpanot ja MCP-palvelimet käynnistyksen yhteydessä, automaattisesti integroivat mukautetut työkalut.
7. Käytä ja tarkista työkaluja:
Käytä komentoja, kuten `/MCP` ja`/MCP DESC`, vahvistaa työkalujen saatavuus ja olla vuorovaikutuksessa mukautettujen lisäysten kanssa.
tämän arkkitehtuurin edut
- Modulaarisuus: Työkalut toimivat erillisinä MCP -palvelimina, mikä tekee kehityksestä riippumattoman ja skaalautuvan.
- Dynaaminen integraatio: Työkalut ilmestyvät automaattisesti Gemini CLI -työnkulkuissa ilman koodausta.
- Turvallisuus ja hallinta: Laajennukset voivat rajoittaa, mitkä työkalut tai kuorikomennot ovat sallittuja, mikä estää väärinkäytön.
- Uudelleenkäytettävyys: Laajennukset Paketti Täydelliset työnkulut, jaettavissa projektien tai ryhmien välillä.
- Yhteisö- ja ekosysteemi: Monia MCP -palvelimia ja laajennuksia on saatavana tai ne voidaan osallistua, laajentaen nopeasti Gemini CLI -ominaisuuksia.
Tämä arkkitehtuuri mahdollistaa käytännöllisesti katsoen minkä tahansa ulkoisen työkalun, komentosarjan tai palvelun integroinnin Gemini CLI -ekosysteemiin, lisäämällä tuottavuutta ja räätälöintiä.
***
Tämä vastaus tarjoaa perusteellisen selityksen Gemini CLI -työkaluista ja laajennuksen integrointimekanismeista, mukaan lukien MCP -palvelimet, laajennuspakkaukset, mukautetut komennot ja skriptin integrointi, täydentävät pyydettyjä pituuksia ja yksityiskohtia. Seuraavaksi voidaan toimittaa haluttaessa tarkempia MCP SDK -käyttö- tai esimerkkikokoonpanoja.
Kaikki tiedot perustuvat arvovaltaiseen Gemini CLI -dokumentaatioon ja yhteisölähteisiin, jotka ovat saatavilla syyskuusta 2025.