Jak mogę dodać niestandardowe narzędzia lub rozszerzenia do Gemini CLI

Rozszerzanie CLI Gemini o niestandardowe narzędzia za pośrednictwem MCP

Bliźnięta CLI zostało zaprojektowane tak, aby można było rozszerzyć za pośrednictwem protokołu kontekstowego modelu (MCP). MCP działa jako znormalizowany sposób łączenia usług zewnętrznych i możliwości (narzędzi) z Gemini CLI. Konfigurując serwery MCP, Gemini CLI może bezproblemowo zintegrować te zewnętrzne narzędzia z opartą na AI-AI-AI-Dowviden Polegle i rozumowania.

- Konfigurowanie serwerów MCP:
Zaczynasz od konfiguracji serwerów MCP w pliku Ustawienia CLI Gemini, zwykle znajdującego się na `~/.gemini/settings.json`. Ten plik JSON konfiguruje, z czym serwery MCP należy łączyć, w tym w razie potrzeby szczegóły połączenia i uwierzytelnianie.

- Korzystanie z istniejących lub niestandardowych serwerów MCP:
Wiele istniejących serwerów MCP interfejs z popularnymi usługami, takimi jak GitHub, Gitlab, Firebase, bazy danych lub generowanie mediów. Aby uzyskać naprawdę niestandardowe funkcjonalność, możesz tworzyć własne serwery MCP za pomocą SDK MCP dostępnych w językach takich jak Python lub TypeScript. Umożliwia to hosting dowolnej niestandardowej logiki lub narzędzia jako serwera MCP.

- Konfigurowanie serwerów MCP:
W pliku „settings.json` serwery MCP są zdefiniowane za pomocą ich nazw, typów serwerów, poleceń połączeń lub adresów URL, tokenów do uwierzytelnienia i wszelkich wyspecjalizowanych parametrów. Po skonfigurowaniu Gemini CLI połączy się z tymi serwerami podczas uruchamiania.

- Odkrycie i wykorzystanie narzędzi:
Po połączeniu serwery MCP ujawniają narzędzia, które Gemini CLI automatycznie odkrywa. Możesz wymienić i opisać te narzędzia z poleceniami takimi jak `/mcp` i`/mcp desc`. Następnie agent AI integruje je natywnie z przepływem decyzyjnym i wykonaniem, wybierając narzędzia w razie potrzeby na podstawie monitów użytkownika bez ręcznej interwencji.

Tworzenie rozszerzeń CLI Gemini CLI

Oprócz serwerów MCP, Gemini CLI obsługuje koncepcję wyższego poziomu o nazwie rozszerzenia, które łączą serwery MCP, pliki kontekstowe i niestandardowe polecenia, aby rozszerzyć funkcjonalność Gemini CLI.

- Lokalizacja rozszerzenia:
Rozszerzenia mogą znajdować się w dwóch podstawowych lokalizacjach: `/.gemini/rozszerzenia/` lub `/.gemini/rozszerzenia/`. Bliźnięta CLI ładuje wszystkie rozszerzenia znalezione w obu lokalizacjach podczas uruchamiania, z rozszerzeniami specyficznymi dla obszarów roboczych, zastępuje wersje katalogu domowego, jeśli pojawią się konflikty nazwy.

- Struktura rozszerzenia:
Każde rozszerzenie jest katalogiem nazwanym na podstawie rozszerzenia (np. „My-Extension`), który zawiera plik konfiguracyjny o nazwie„ gemini-extension.json`. Ten JSON zawiera konfiguracje metadanych i serwerów.

- Treść gemini-extension.json:
Typowe klucze w tym pliku obejmują:

- `Nazwa ': Unikalna nazwa rozszerzenia.
- `wersja: wersja rozszerzenia.
- `McPservers`: Mapa serwerów MCP skonfigurowana przez rozszerzenie, np. Polecenia do uruchomienia niestandardowych serwerów MCP.
- `ContextFileName`: Opcjonalnie. Nazwa pliku kontekstowego załadowanego jako kontekst przestrzeni roboczej dla rozszerzenia, domyślnie do „gemini.md`.
- `ExcludeTools`: tablica określająca narzędzia lub polecenia narzędzi do wykluczenia, przydatne do blokowania niebezpiecznych lub niepożądanych operacji.

- Polecenia niestandardowe w rozszerzeniach:
Rozszerzenia mogą dostarczać niestandardowe polecenia cięcia, umieszczając pliki definicji polecenia .TOML` w podwodnicy `` `` w katalogu rozszerzenia. Polecenia te są zdefiniowane podobnie do poleceń specyficznych dla użytkownika lub projektu.

- Scalanie:
Kiedy uruchamia się Gemini CLI, łączy konfiguracje rozszerzenia z głównymi ustawieniami użytkownika i wbudowanymi narzędziami, rozwiązywając konflikty, dając priorytet ustawienia przestrzeni roboczej.

Tworzenie niestandardowych poleceń cięcia z plikami TOML

Elastycznym sposobem dodawania poleceń wielokrotnego użytku (narzędzi) jest użycie plików `.TOML` jako niestandardowych poleceń.

- Lokalizacja:
Umieść pliki poleceń TOML w `~/.Gemini/Commands/` dla poleceń globalnych lub w katalogu Project-Local `.Gemini/Commands/`.

- Format TOML:
Pliki te definiują polecenie, monitowe szablony i mogą zawierać argumenty z symbolami zastępczymi takimi jak `` {args> `. Obsługują również wykonywanie polecenia powłoki w wierszu za pomocą składni, takiej jak `! {...}` `w celu osadzania skryptów.

- Zastosowanie:
Polecenia te można wywoływać bezpośrednio w CLI Bliźnięta za pomocą poleceń Slash, takich jak „/MyCommand`, umożliwiając łatwo skrypowe przepływy pracy lub integracje.

Uruchamianie niestandardowych scenariuszy Python i poleceń powłoki

- Ponieważ Gemini CLI obsługuje uruchomione polecenia i skrypty powłoki, możesz wyzwolić niestandardowe skrypty Python lub inne programy w ramach serwera MCP lub niestandardowych przepływów pracy.

- Na przykład skrypt Python generujący PDF z odpowiedzi CLI Gemini może być owinięte na serwerze MCP lub wykonane jako polecenie powłoki w niestandardowym poleceniu TOML, umożliwiając przepływy pracy generowania jednego.

Integracja z IDES i środowiskiem

- Rozszerzenia CLI GEMINI mogą również zwiększyć integrację z IDE, takie jak kod, udostępniając kontekst przestrzeni roboczej (pliki, lokalizacja kursora, wybór), umożliwiając przepływy pracy kodu opartego na AI.

- Rozszerzenia i serwery MCP pomagają zintegrować dostosowane przepływy pracy bezpośrednio ze środowiskiem CLI lub IDE, poprawia wydajność i elastyczność narzędzi.

Podsumowanie procesu w celu dodania niestandardowych narzędzi lub rozszerzeń

1. Zdecyduj zakres narzędzia niestandardowego:
Określ, czy jest to proste polecenie niestandardowe, skrypt lub w pełni wykładana usługa zewnętrzna.

2. Dla prostych niestandardowych poleceń:
Utwórz `.Toml` Pliki definiujące polecenia cięcia i umieść je w folderze odpowiednim poleceń.

3. Dla usług zewnętrznych lub złożonej logiki:
Opracuj serwer MCP za pomocą MCP SDK (wspierające języki takie jak Python lub TypeScript), który ujawnia możliwości narzędzia za pośrednictwem standardowego interfejsu API.

4. Skonfiguruj serwer MCP w `settings.json` lub rozszerzenie:
Dodaj wpis konfiguracji serwera MCP (z poleceniem lub adresem URL) albo bezpośrednio w konfiguracji użytkownika `~/.gemini/settings.json` lub wewnątrz pliku„ gemini-extension.json` w katalogu rozszerzenia.

5. Opcjonalnie pakuj rozszerzenie:
Pakuj swoje serwery MCP, polecenia niestandardowe i pliki kontekstowe w strukturze katalogu rozszerzenia pod `.gemini/rozszerzenia/`.

6. Rozpocznij lub uruchom ponownie Gemini CLI:
Gemini CLI ładuje wszystkie konfiguracje i serwery MCP podczas uruchamiania, automatyczne integrujące narzędzia niestandardowe.

7. Użyj i weryfikuj narzędzia:
Użyj poleceń takich jak `/mcp` i`/mcp desc`, aby potwierdzić dostępność narzędzia i interakcję z niestandardowymi dodatkami.

Korzyści z tej architektury

- Modułowość: Narzędzia działają jako osobne serwery MCP, co czyni rozwój niezależnym i skalowalnym.

- Integracja dynamiczna: Narzędzia pojawiają się automatycznie w przepływach roboczych CLI BLIGINI bez hardkodowania.

- Bezpieczeństwo i kontrola: Rozszerzenia mogą ograniczyć, które narzędzia lub polecenia powłoki są dozwolone, zapobiegając niewłaściwemu użyciu.

- Ponowne użycie: Pakiet rozszerzeń Kompletne przepływy pracy, udostępnienie projektów lub zespołów.

- Community and Ecosystem: Wiele serwerów i rozszerzeń MCP jest dostępnych lub można je wnieść, szybko rozszerzając możliwości Gemini CLI.

Ta architektura umożliwia integrację praktycznie każdego zewnętrznego narzędzia, skryptu lub usługi z ekosystemem CLI Gemini, zwiększając wydajność i dostosowywanie.

***

Ta odpowiedź zawiera dokładne wyjaśnienie niestandardowych mechanizmów integracji narzędzi i rozszerzenia BLIGINI CLI, w tym serwerów MCP, opakowań rozszerzenia, poleceń niestandardowych i integracji skrypcji, spełniania wymaganej długości i szczegółów. W razie potrzeby można znaleźć więcej szczegółów dotyczących użycia SDK MCP lub przykładowych konfiguracji.