Как я могу добавить пользовательские инструменты или расширения в CLI Gemini

расширение CLI Gemini с помощью пользовательских инструментов через MCP

Gemini CLI предназначен для расширения с помощью протокола контекста модели (MCP). MCP действует как стандартизированный способ подключения внешних служб и возможностей (инструментов) к Gemini CLI. Настраивая серверы MCP, Gemini CLI может беспрепятственно интегрировать эти внешние инструменты в свой рабочий процесс, управляемый AI и рассуждения.

- Настройка серверов MCP:
Вы начинаете с настройки серверов MCP в файле настройки CLI Gemini, обычно встречающихся по адресу `~/.gemini/settings.json`. Этот файл JSON настраивает, с какими серверами MCP подключиться, включая детали подключения и аутентификацию, если это необходимо.

- Использование существующих или пользовательских серверов MCP:
Многие существующие серверы MCP взаимодействуют с популярными услугами, такими как Github, Gitlab, Firebase, базы данных или генерация средств массовой информации. Для действительно пользовательских функций вы можете создать свои собственные серверы MCP, используя MCP SDK, доступные на таких языках, как Python или TypeScript. Это позволяет размещать любую пользовательскую логику или инструмент в качестве сервера MCP.

- Настройка серверов MCP:
В файле `futs.json` серверы MCP определяются с их именами, типами серверов, командами соединения или URL -адресами, токенами для аутентификации и любыми специализированными параметрами. После настройки Gemini CLI подключится к этим серверам при запуске.

- Обнаружение и использование инструментов:
После подключения серверы MCP обнажают инструменты, которые Gemini CLI автоматически обнаруживает. Вы можете перечислить и описать эти инструменты с такими командами, как `/mcp` и`/mcp desc '. Затем агент AI вписывает их в свой поток принятия решений и выполнения, выбирая инструменты по мере необходимости на основе подсказок пользователей без ручного вмешательства.

Создание расширений CLI Gemini

Помимо серверов MCP, Gemini CLI поддерживает концепцию более высокого уровня, называемую расширениями, которая объединяет серверы MCP, файлы контекста и пользовательские команды для расширения функциональности CLI Gemini.

- Расположение расширения:
Расширения могут находиться в двух основных местах: `/.gemini/extensions/` или `/.gemini/extensions/`. Gemini CLI загружает все расширения, обнаруженные в обоих местах при запуске, причем удлинители, специфичные для рабочего пространства, переопределяющие версии домашнего каталога, если возникают конфликты имени.

- Структура расширения:
Каждое расширение представляет собой каталог, названный в честь расширения (например, `my-extension`), который содержит файл конфигурации с именем` gemini-extension.json`. Этот JSON включает в себя метаданные и конфигурации сервера.

- Gemini-extension.json Content:
Типичные ключи в этом файле включают:

- `name`: уникальное имя расширения.
- `версия ': расширение версии.
- `mcpervers`: карта серверов MCP, настроенная расширением, например, команды для запуска пользовательских серверов MCP.
- `contextfilename`: необязательно. Имя контекстного файла, загруженного как контекст рабочей области для расширения, по умолчанию к `gemini.md`.
- `excludeTools`: массив, определяющий инструменты или команды инструментов, чтобы исключить, полезно для блокировки опасных или нежелательных операций.

- Пользовательские команды в расширениях:
Расширения могут предоставлять пользовательские команды SLASH, размещая файлы определения команды `.toml` в подкаталорию` команды/`в каталоге расширения. Эти команды определяются аналогично командам пользователя или проекта.

- поведение слияния:
Когда запускается Gemini CLI, он объединяет конфигурации расширения с основными настройками пользователя и встроенными инструментами, разрешая конфликты, предоставляя приоритет настройки рабочей области.

Создание пользовательских команд Slash с помощью файлов Toml

Гибкий способ добавления многоразовых команд (инструменты) - это использование файлов .toml` в качестве пользовательских команд SLASH.

- Расположение:
Поместите командные файлы Toml в `~/.Gemini/Commands/` для глобальных команд или в каталоге Project-Local `.gemini/` ``.

- формат Toml:
Эти файлы определяют команду, шаблоны подсказки и могут включать аргументы с такими заполнителями, как ``. Они также поддерживают выполнение команды оболочки в подсказке, используя синтаксис, например, `! {...}` для встраивания сценариев.

- Использование:
Эти команды могут быть вызваны непосредственно в CLI Gemini через команды SLASH, такие как `/mycommand`, позволяя легко сценаривым рабочим процессам или интеграциям.

Запуск пользовательских сценариев Python и команд оболочки

- Поскольку Gemini CLI поддерживает запуск команд Shell и сценариев, вы можете запустить пользовательские сценарии Python или другие программы как часть вашего MCP -сервера или пользовательских рабочих процессов команд.

- Например, сценарий Python, генерирующий PDF-файлы из ответов Gemini CLI, может быть завершен на сервере MCP или выполнен в качестве команды оболочки в пользовательской команде Toml, что позволяет одному командованию рабочие процессы генерации.

Интеграция с IDES и Environment

- Расширения Gemini CLI также могут улучшить интеграцию с IDE, такими как VS-код, путем обмена контекстом рабочей области (файлы, местоположение курсора, выбор), обеспечение рабочих процессов помощи, управляемой AI.

- Расширения и серверы MCP помогают интегрировать индивидуальные рабочие процессы непосредственно в среду CLI или IDE, повышая производительность и гибкость инструментов.

Сводка процесса для добавления пользовательских инструментов или расширений

1. Определите область применения пользовательского инструмента:
Определите, является ли это простой пользовательской командой, сценарием или полностью отготовленной внешней службой.

2. Для простых пользовательских команд:
Создайте файлы .toml`, определяющие команды SLASH и поместите их в соответствующую папку команд.

3. Для внешних служб или сложной логики:
Разработайте сервер MCP, используя MCP SDK (поддерживающие языки, такие как Python или TypeScript), который раскрывает возможности инструмента с помощью стандартизированного API.

4. Настройте MCP -сервер в `sutre.json` или расширение:
Добавьте запись конфигурации сервера MCP (с помощью команды или URL) либо непосредственно в пользовательском конфигурации `~/.gemini/settings.json` или внутри файла` gemini-extension.json` в каталоге расширения.

5. Опционально объедините в расширении:
Упакуйте свои серверы MCP, пользовательские команды и файлы контекста в структуру каталога расширения в рамках `.gemini/extensions/`.

6. Начните или перезапустите CLI Gemini:
Gemini CLI загружает все конфигурации и серверы MCP на запуск, автоматические интеграционные пользовательские инструменты.

7. Используйте и проверяйте инструменты:
Используйте такие команды, как `/mcp` и`/mcp desc ', чтобы подтвердить доступность инструмента и взаимодействовать с вашими пользовательскими дополнениями.

Преимущества этой архитектуры

- Модульность: инструменты работают как отдельные серверы MCP, что делает разработку независимыми и масштабируемыми.

- Динамическая интеграция: инструменты автоматически появляются в рабочих процессах Gemini CLI без жесткого кодирования.

- Безопасность и управление: расширения могут ограничить, какие инструменты или команды оболочки разрешены, предотвращая неправильное использование.

- Повторно используйте: пакет расширений Полный рабочие процессы, общие между проектами или командами.

- Сообщество и экосистема: многие серверы и расширения MCP доступны или могут быть внесены, быстро расширяя возможности CLI Gemini.

Эта архитектура позволяет интегрировать практически любой внешний инструмент, сценарий или сервис в экосистему Gemini CLI, повышая производительность и настройку.

***

Этот ответ дает подробное объяснение индивидуальных инструментов и механизмов интеграции Gemini CLI, включая серверы MCP, упаковку удлинения, пользовательские команды и интеграцию сценариев, соответствующие запрашиваемой длине и подробности. При желании можно предоставить дополнительные особенности использования MCP SDK или примеров конфигураций.