Щоб додати спеціальні інструменти або розширення до Gemini CLI, основний механізм - через протокол контексту моделі (MCP) та спеціальні розширення, які підтримує Gemini CLI. Нижче наведено детальний посібник з ключовими аспектами та кроками для додавання спеціальних інструментів або розширень до Gemini Cli:
Розширення Gemini CLI за допомогою спеціальних інструментів через MCP
Gemini CLI розроблений таким чином, щоб бути розширеним за допомогою протоколу контексту моделі (MCP). MCP виступає стандартизованим способом підключення зовнішніх послуг та можливостей (інструментів) до Gemini CLI. Налаштуючи сервери MCP, Gemini CLI може безперешкодно інтегрувати ці зовнішні інструменти в свою команду, керовану AI та робочий процес міркувань.
- Налаштування серверів MCP:
Ви починаєте з налаштування серверів MCP у файлі налаштувань Gemini CLI, який зазвичай зустрічається на `~/.gemini/settings.json`. Цей файл JSON налаштовує те, з якими сервери MCP можна підключитися, включаючи деталі підключення та аутентифікацію, якщо це потрібно.
- Використання існуючих або користувацьких серверів MCP:
Багато існуючих серверів MCP інтерфейс з популярними послугами, такими як Github, Gitlab, Firebase, бази даних або створення медіа. Для справді користувацької функціональності ви можете створити власні сервери MCP за допомогою SDK MCP, доступних на таких мовах, як Python або TypeScript. Це дозволяє розмістити будь -яку власну логіку чи інструмент як сервер MCP.
- Налаштування серверів MCP:
У файлі `settings.json` сервери MCP визначаються за допомогою їх імен, типів серверів, командами підключення або URL -адрес, жетонів для аутентифікації та будь -яких спеціалізованих параметрів. Після налаштування, Gemini CLI підключиться до цих серверів при запуску.
- Відкриття та використання інструментів:
Після з'єднання сервери MCP розкривають інструменти, які Booti Cli автоматично виявляє. Ви можете перелічити та описати ці інструменти за допомогою таких команд, як `/MCP` та`/MCP DESC`. Потім агент AI інтегрує їх у своєму плані прийняття рішень та виконання, вибираючи інструменти за потребою на основі підказок користувача без ручного втручання.
Створення розширень CLI Bowini
Крім серверів MCP, Gemini CLI підтримує концепцію вищого рівня під назвою розширення, яка поєднує серверів MCP, контекстних файлів та спеціальних команд для розширення функціональності Gemini CLI.
- Розширення розташування:
Розширення можуть проживати у двох первинних місцях: `/.gemini/розширення/` або `/.gemini/розширення/`. Gemini CLI завантажує всі розширення, знайдені в обох місцях для запуску, при цьому розширення, що стосуються робочої області, переважають версії домашніх каталогів, якщо виникають конфлікти імен.
- Структура розширення:
Кожне розширення-це каталог, названий на честь розширення (наприклад, `my-extension`), який містить файл конфігурації під назвою` gemini-extension.json`. Цей JSON включає метадані та конфігурації сервера.
- gemini-extension.json вміст:
Типові ключі в цьому файлі включають:
- `Ім'я`: Унікальна назва розширення.
- `Версія ': Версія розширення.
- `MCPSERVERS`: Карта серверів MCP, налаштованих на розширення, наприклад, команди для запуску спеціальних серверів MCP.
- `Контекстфіленаді ': необов’язково. Назва контекстного файлу, завантаженого як контекст робочої області для розширення, за замовчуванням до `jemini.md`.
- `excludeTools`: масив, що вказує інструменти або команди інструментів, які для виключення, корисні для блокування небезпечних або небажаних операцій.
- Спеціальні команди в розширеннях:
Розширення можуть надати спеціальні команди косої риси, розмістивши файли визначення команди `.toml` у підрозділі` `` підкаталог у каталозі розширення. Ці команди визначаються аналогічно командам користувачів або проектів.
- Поведінка злиття:
Коли Gemini CLI запускається, він об'єднує конфігурації розширення з основними налаштуваннями користувача та вбудованими інструментами, вирішуючи конфлікти, надаючи пріоритет налаштування робочої області.
Створення власних команд косої трасу з файлами TOML
Гнучкий спосіб додавання команд (інструментів) - це використання файлів `.toml` як користувацькі команди косоки.
- Розташування:
Помістіть командні файли TOML у `~/.gemini/команди/` для глобальних команд або в локальному `.gemini/командах/` каталог.
- Формат TOML:
Ці файли визначають команду, оперативні шаблони та можуть включати аргументи з заповнювачами, такими як `
- Використання:
Ці команди можна викликати безпосередньо в Gemini CLI за допомогою команд Slash, таких як `/myCommand`, що дозволяє легко скласти робочі процеси або інтеграції.
Запуск спеціальних сценаріїв Python та команд Shell
- Оскільки Gemini CLI підтримує запуск команд та сценаріїв Shell, ви можете запустити спеціальні сценарії Python або інші програми як частину вашого сервера MCP або спеціальних командних робочих процесів.
- Наприклад, сценарій Python, що генерує PDF-файли від відповідей Gemini CLI, може бути загорнутий на сервер MCP або виконана як команда Shell у власній команді TOML, що дозволяє одночасно генерувати робочі процеси.
Інтеграція з IDE та навколишнім середовищем
- Розширення CLI Gemini також може вдосконалити інтеграцію з IDE, як код VS, шляхом обміну контекстом робочої області (файли, розташування курсору, вибір), що дозволяє працювати з кодом, керованими AI.
- Розширення та сервери MCP допомагають інтегрувати індивідуальні робочі процеси безпосередньо в середовище CLI або IDE, покращуючи продуктивність та гнучкість інструментів.
Підсумок процесу для додавання спеціальних інструментів або розширень
1. Вирішіть обсяг спеціального інструменту:
Визначте, чи це проста власна команда, сценарій чи повноцінна зовнішня послуга.
2. Для простих власних команд:
Створіть файли `.toml`, що визначають команди косоки та розміщуйте їх у папці відповідних команд.
3. Для зовнішніх служб або складної логіки:
Розробити сервер MCP за допомогою SDK MCP (підтримуючі мови, такі як Python або TypeScript), які розкривають можливості інструменту за допомогою стандартизованого API.
4. Налаштуйте MCP Server у `settings.json` або розширення:
Додайте запис конфігурації сервера MCP (за допомогою команди або URL) або безпосередньо в конфігурацію користувача `~/.gemini/settings.json` або всередині файлу` gemini-extension.json` у каталозі розширення.
5. Необов’язково пакет у розширенні:
Упакуйте свої сервери MCP, спеціальні команди та контекстні файли в структуру каталогу розширення в рамках `.gemini/розширення/`.
6. Почніть або перезапустіть Близнюки CLI:
Gemini CLI завантажує всі конфігурації та сервери MCP при запуску, автоматично інтегруючи спеціальні інструменти.
7. Використовуйте та перевіряйте інструменти:
Використовуйте такі команди, як `/MCP` та`/MCP DESC`, щоб підтвердити доступність інструменту та взаємодіяти з вашими спеціальними доповненнями.
Переваги цієї архітектури
- Модульність: Інструменти працюють як окремі сервери MCP, що робить розробку незалежною та масштабованою.
- Динамічна інтеграція: Інструменти автоматично з'являються в робочих процесах Gemini CLI без жорсткого кодування.
- Безпека та контроль: розширення можуть обмежити, які інструменти або команди оболонки дозволені, запобігаючи зловживанню.
- Повторне використання: Пакет розширення Повні робочі процеси, обмін для проектів чи команд.
- Спільнота та екосистема: Багато серверів MCP та розширення доступні або можуть бути внесені, швидко розширюючи можливості Bowini CLI.
Ця архітектура дозволяє практично будь -якому зовнішньому інструменту, сценарію чи послузі в інтегрованню в екосистему Gemini CLI, підвищення продуктивності та налаштування.
***
Ця відповідь дає ретельне пояснення спеціальних інструментів та механізмів інтеграції розширення Gemini CLI, включаючи сервери MCP, упаковку розширення, користувацькі команди та інтеграцію сценаріїв, дотримання довжини та деталей запитуваної. За бажанням можна надати більше специфіки щодо використання MCP SDK або прикладних конфігурацій.
Вся інформація ґрунтується на авторитетній документації Gemini CLI та джерелах громади, доступних станом на вересень 2025 року.