Gemini MCP Tool
MCP-сервер, который дает агенту обращаться к Gemini через его CLI для разбора больших файлов и целых кодовых баз
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Запускает внешний CLI как подпроцесс и передает содержимое файлов в сервис Google
- Может выполнять код в песочнице Gemini по запросу
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/gemini-mcp-toolОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio gemini-cli -- npx -y gemini-mcp-toolИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"gemini-cli": {
"command": "npx",
"args": [
"-y",
"gemini-mcp-tool"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"gemini-cli": {
"command": "npx",
"args": [
"-y",
"gemini-mcp-tool"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"gemini-cli","type":"stdio","command":"npx","args":["-y","gemini-mcp-tool"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"gemini-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gemini-mcp-tool"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add gemini-cli -- npx -y gemini-mcp-toolИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.gemini-cli]
command = "npx"
args = ["-y", "gemini-mcp-tool"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"gemini-cli": {
"command": "npx",
"args": [
"-y",
"gemini-mcp-tool"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"gemini-cli": {
"command": "npx",
"args": [
"-y",
"gemini-mcp-tool"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"gemini-cli": {
"command": "npx",
"args": [
"-y",
"gemini-mcp-tool"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"gemini-cli": {
"command": "npx",
"args": [
"-y",
"gemini-mcp-tool"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"gemini-cli": {
"type": "local",
"command": [
"npx",
"-y",
"gemini-mcp-tool"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"gemini-cli": {
"command": "npx",
"args": [
"-y",
"gemini-mcp-tool"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"gemini-cli": {
"command": "npx",
"args": [
"-y",
"gemini-mcp-tool"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Убедись, что установлен и настроен Gemini CLI или Antigravity CLI, затем подключи сервер командой claude mcp add gemini-cli -- npx -y gemini-mcp-tool. Дальше проси разбирать файлы через синтаксис @.
Другие способы из описания автора
claude mcp add gemini-cli -- npx -y gemini-mcp-toolПодключает сервер к Claude Code. Заранее нужен установленный Gemini CLI или Antigravity CLI.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает кодового агента с командной строкой Gemini и позволяет отдавать Gemini объемные задачи, используя его большое контекстное окно. Через синтаксис @ в запрос можно подставлять файлы и каталоги, чтобы Gemini разобрал их и вернул объяснение или сводку, а основной агент сэкономил свой контекст. Есть инструмент вопросов к Gemini, режим совместного мозгового штурма и песочница для безопасного прогона кода. После того как Google свернул бесплатный доступ к Gemini CLI, сервер по умолчанию переключается на преемника, Antigravity CLI, а для платных и корпоративных тарифов прежний бэкенд включается переменной окружения. Авторизация выполняется во внешнем CLI, сам сервер ключей не хранит.
Для кого. Для разработчиков, которые работают в кодовом агенте и хотят отдавать разбор крупных файлов и репозиториев в Gemini.
Подходит, если
- Нужно разобрать большой файл или целый репозиторий, который не помещается в контекст основного агента
- Хочется получить второе мнение от Gemini прямо из кодового агента
- Нужно безопасно прогнать код или скрипт в песочнице Gemini
Не подходит, если
- Нет установленного и настроенного Gemini CLI или Antigravity CLI
- Задача небольшая и укладывается в контекст основного агента без обращения наружу
Пример запроса к агенту
Попроси gemini разобрать @src и объяснить, как устроен основной поток данныхОграничения
Нужен Node.js от 16 версии и установленный Gemini CLI или Antigravity CLI, вход выполняется в самом CLI. Google свернул бесплатный доступ к Gemini CLI, поэтому по умолчанию используется Antigravity CLI, и его бэкенд помечен как экспериментальный с ограничениями по моделям и песочнице. Сервисы Gemini и Antigravity от Google из России без VPN недоступны. Это неофициальный сторонний инструмент, он не связан с Google.
Как отключить. Удалите запись gemini-cli из конфигурации MCP-клиента. В Claude Code это делается командой claude mcp remove gemini-cli.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| GEMINI_MCP_BACKEND | Выбор бэкенда: gemini или agy. Без значения используется вариант по умолчанию с учетом даты, с 2026-06-18 это agy. |
| AGY_CLI_PATH | Полный путь к бинарнику agy, если его нет в PATH сервера. |
Проверка безопасности
- Запускает внешний CLI как подпроцесс и передает содержимое файлов в сервис Google
- Может выполнять код в песочнице Gemini по запросу
Коротко о README
README описывает MCP-сервер, который связывает AI-ассистента с командной строкой Gemini, чтобы использовать ее большое контекстное окно для разбора крупных файлов и кодовых баз. Файлы и каталоги подставляются в запрос через синтаксис @, есть инструменты вопросов, мозгового штурма и песочница для безопасного выполнения кода. Отдельно разобран переход с закрытого бесплатного Gemini CLI на Antigravity CLI и переменные окружения, которые управляют выбором бэкенда, путем к бинарнику и тайм-аутом. Установка идет одной командой через npx или добавлением записи в конфигурацию MCP-клиента. Инструмент неофициальный и не связан с Google, лицензия MIT.
Частые вопросы
Нужен ли отдельный ключ в конфигурации сервера?
Нет, ключей сервер не хранит. Авторизация и доступ настраиваются в самом Gemini CLI или Antigravity CLI, куда нужно один раз войти.
Что с бесплатным Gemini CLI?
Google свернул его бесплатный доступ, поэтому сервер по умолчанию переключается на Antigravity CLI. Платные и корпоративные тарифы могут вернуть прежний бэкенд переменной окружения.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything