Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon Hogyan adhatok hozzá egyedi eszközöket vagy kiterjesztéseket a Gemini CLI -hez


Hogyan adhatok hozzá egyedi eszközöket vagy kiterjesztéseket a Gemini CLI -hez


Az egyedi eszközök vagy kiterjesztések hozzáadásához az Ikrek CLI -hez az elsődleges mechanizmus a Model Context Protocol (MCP) és az egyéni kiterjesztések révén, amelyeket a Gemini CLI támogat. Az alábbiakban egy részletes útmutató található, amelynek legfontosabb szempontjai és lépései vannak az egyéni eszközök vagy kiterjesztések hozzáadásához a Gemini CLI -hez:

A Gemini CLI kiterjesztése egyedi eszközökkel az MCP -n keresztül

A Gemini CLI -t úgy tervezték, hogy kiterjeszthető legyen a Model Context Protocol (MCP) révén. Az MCP szabványosított módszerként szolgál a külső szolgáltatások és képességek (eszközök) csatlakoztatásához a Gemini CLI -hez. Az MCP-kiszolgálók konfigurálásával a Gemini CLI zökkenőmentesen integrálhatja ezeket a külső eszközöket az AI-vezérelt parancsba és az érvelési munkafolyamatba.

- Az MCP -kiszolgálók beállítása:
Az MCP -kiszolgálók konfigurálásával kezdve a Gemini CLI Settings fájlban, amelyet általában a `~/.gemini/settings.json` található. Ez a JSON -fájl konfigurálja, hogy milyen MCP -kiszolgálók kapcsolódjanak össze, beleértve a kapcsolat részleteit és a szükséges hitelesítést.

- A meglévő vagy egyedi MCP szerverek használata:
Számos meglévő MCP -kiszolgáló interfész a népszerű szolgáltatásokkal, mint például a GitHub, a GitLab, a FireBase, az adatbázisok vagy a médiatermelés. A valóban egyedi funkcionalitás érdekében létrehozhat saját MCP -kiszolgálóit az MCP SDK használatával, amely olyan nyelveken elérhető, mint a Python vagy a TypeScript. Ez lehetővé teszi bármilyen egyedi logika vagy eszköz tárolását MCP szerverként.

- Az MCP szerverek konfigurálása:
A „Settings.json” fájlban az MCP szervereket a nevükkel, a szerver típusokkal, a csatlakozási parancsokkal vagy az URL -ekkel, a hitelesítésre és a speciális paraméterekkel definiálják. A konfigurálás után a Gemini CLI csatlakozik ezekhez a szerverekhez az indításkor.

- Az eszközök felfedezése és használata:
A kapcsolat után az MCP szerverek olyan eszközöket tesznek ki, amelyeket a Gemini CLI automatikusan felfedez. Felsorolhatja és leírhatja ezeket az eszközöket olyan parancsokkal, mint a `/MCP` és a`/MCP DESC`. Az AI ügynök ezután natív módon integrálja őket a döntéshozatali és végrehajtási folyamatba, és szükség szerint kiválasztja az eszközöket, a felhasználói utasítások alapján kézi beavatkozás nélkül.

Gemini CLI kiterjesztések létrehozása

Az MCP szervereken túl a Gemini CLI támogatja a magasabb szintű, az Extensions nevű koncepciót, amely összekapcsolja az MCP szervereket, a kontextusfájlokat és az egyéni parancsokat a Gemini CLI funkcionalitás kiterjesztésére.

- Bővítés helye:
A kiterjesztések két elsődleges helyen tartózkodhatnak: `/.gemini/kiterjesztések/` vagy `/.gemini/kiterjesztések/`. A Gemini CLI betölti az indításkor mindkét helyszínen található összes kiterjesztést, a munkaterület-specifikus kiterjesztések felülbíráló otthoni könyvtári verzióival, ha névkonfliktusok merülnek fel.

- Bővítés szerkezete:
Minden kiterjesztés egy olyan könyvtár, amelyet a kiterjesztés (például a „My-Extension”) elnevezésű könyvtár, amely tartalmaz egy „Gemini-Extension.json” nevű konfigurációs fájlt. Ez a JSON metaadatokat és szerverkonfigurációkat tartalmaz.

- Gemini-Extension.json tartalom:
A fájlban szereplő tipikus kulcsok a következők:

- `név": egyedi kiterjesztés név.
- `Verzió ': Bővítmény verzió.
- `McPServers`: A kiterjesztéssel konfigurált MCP -kiszolgálók térképe, például parancsok az egyedi MCP -kiszolgálók elindításához.
- `ContextFileName ': Opcionális. A kontextusfájl neve, amelyet a kiterjesztés munkaterületének kontextusában tölt be, alapértelmezés szerint a „Gemini.MD” -re.
- `Kinevoolsetools`: Az eszközök vagy eszközparancsok tömb meghatározása, hogy kizárják, hasznosak a veszélyes vagy nem kívánt műveletek blokkolásához.

- Egyéni parancsok kiterjesztésekben:
A kiterjesztések az egyedi perjel parancsokat biztosíthatják, ha a `.toml` parancsdefiníciós fájlokat a„ parancsok/”alkönyvtárba helyezik a kiterjesztési könyvtárba. Ezeket a parancsokat a felhasználó vagy a projekt-specifikus parancsokhoz hasonlóan definiálják.

- Egyesítési viselkedés:
Amikor a Gemini CLI elindul, a felhasználó fő beállításaival és beépített eszközeivel a kiterjesztési konfigurációkat egyesíti, a konfliktusok megoldásával a munkaterület-beállítások prioritásának megadásával.

Egyéni perjel parancsok létrehozása toml fájlokkal

Az újrafelhasználható parancsok (eszközök) hozzáadásának rugalmas módja a.

- Helyszín:
Helyezze a toml parancsfájlokat a `~/.gemini/parancsok/` globális parancsokhoz vagy a projekt-local `.gemini/commands/` könyvtárba.

- Toml formátum:
Ezek a fájlok meghatározzák a parancsot, a prompt sablonokat, és olyan érveket tartalmazhatnak olyan helyőrzőkkel, mint a ``. Támogatják a Shell parancs végrehajtását a Prompt -en belül a szintaxis használatával, mint például a "! {...}" a szkript beágyazásához.

- Használat:
Ezeket a parancsokat közvetlenül a Gemini CLI -ben lehet meghívni olyan perjel -parancsokon keresztül, mint a „/MyCommand”, lehetővé téve a szkriptelt munkafolyamatokat vagy integrációkat.

Egyéni Python szkriptek és Shell parancsok futtatása

- Mivel a Gemini CLI támogatja a Shell parancsokat és szkripteket, kiválthatja az egyedi Python szkripteket vagy más programokat az MCP -kiszolgáló vagy az egyéni parancs -munkafolyamatok részeként.

- Például egy Python szkript, amely a Gemini CLI válaszokból származó PDF-eket generál, be lehet csomagolni egy MCP-kiszolgálóba, vagy Shell parancsként végrehajtható egy egyedi toml parancson, lehetővé téve az egyparancsnoki generációs munkafolyamatokat.

Integráció az IDE -kkel és a környezettel

- A Gemini CLI kiterjesztések javíthatják az integrációt az IDE-kkel, mint például a VS kóddal, a munkaterület kontextusának megosztásával (fájlok, kurzor helye, kiválasztása), lehetővé téve az AI-vezérelt kód segítségnyújtási munkafolyamatokat.

- A kiterjesztések és az MCP -kiszolgálók elősegítik a testreszabott munkafolyamatok integrálását közvetlenül a CLI vagy az IDE környezetbe, javítva a termelékenységet és az eszközlánc rugalmasságát.

Az egyéni eszközök vagy kiterjesztések hozzáadásának folyamatának összefoglalása

1. Döntse el az egyéni eszköz hatályát:
Határozza meg, hogy ez egy egyszerű egyedi parancs, szkript vagy egy teljesen értékes külső szolgáltatás.

2. Az egyszerű egyedi parancsokért:
Hozzon létre `.toml` fájlokat, amelyek meghatározzák a perjel parancsokat, és helyezze be a megfelelő parancsok mappába.

3. Külső szolgáltatások vagy összetett logika esetén:
Fejlesszen ki egy MCP -kiszolgálót az MCP SDK (támogató nyelvek, mint például a Python vagy a TypeScript) használatával, amely a szerszámképességeket szabványosított API -n keresztül teszi ki.

4. Konfigurálja az MCP Server -et a `beállítások.json` vagy kiterjesztésben:
Adja hozzá az MCP Server konfigurációs bejegyzését (paranccsal vagy URL-vel) közvetlenül a `~/.gemini/suttings.json` felhasználói konfigurációban, vagy a„ Gemini-Extension.json ”fájl belsejében egy kiterjesztési könyvtárban.

5. Opcionálisan csomagoljon egy kiterjesztésben:
Csomagolja az MCP szervereit, az egyéni parancsokat és a kontextusfájlokat egy kiterjesztési könyvtári struktúrába a .gemini/kiterjesztések/`alatt.

6. Indítsa el vagy indítsa újra a Gemini CLI -t:
A Gemini CLI az összes konfigurációt és az MCP-kiszolgálót betölti az indításkor, automatikusan integráló egyedi eszközöket.

7. Használja és ellenőrizze az eszközöket:
Használjon olyan parancsokat, mint a „/MCP” és a „/MCP DESC” az eszköz elérhetőségének megerősítéséhez és az egyedi kiegészítésekkel való kölcsönhatáshoz.

ennek az építészetnek az előnyei

- Modularitás: Az eszközök külön MCP szerverként futnak, így a fejlesztés független és méretezhető.

- Dinamikus integráció: Az eszközök automatikusan megjelennek a Gemini CLI munkafolyamatokban, kemény kódolás nélkül.

- Biztonság és vezérlés: A kiterjesztések korlátozhatják, mely eszközöket vagy a héj parancsát megengedik, megakadályozva a visszaélést.

- Újrafelhasználhatóság: Bővítők csomagja teljes munkafolyamatok, megosztható projektek vagy csapatok között.

- Közösségi és ökoszisztéma: Számos MCP -kiszolgáló és kiterjesztés áll rendelkezésre, vagy hozzájárulhat, gyorsan bővülő Gemini CLI képességek.

Ez az architektúra lehetővé teszi, hogy gyakorlatilag bármilyen külső eszköz, szkript vagy szolgáltatás integrálódjon a Gemini CLI ökoszisztémába, növelve a termelékenységet és a testreszabást.

***

Ez a válasz alapos magyarázatot ad a Gemini CLI egyedi eszköz- és kiterjesztési integrációs mechanizmusainak, beleértve az MCP -kiszolgálókat, a kiterjesztés csomagolását, az egyéni parancsokat és a szkriptek integrációját, a kért hosszúság és részlet megfelelését. Ha szükséges, az MCP SDK használatával vagy a példakonfigurációkkal kapcsolatos részletesebbek is megadhatók.

Az összes információ 2025 szeptemberétől elérhető hiteles Ikrek CLI dokumentációján és közösségi forrásokon alapul.