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 `
- 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.