Colab-MCP (unofficial) — MCP-сервер для Claude Code: установка
MCP-сервер Colab-MCP (unofficial) для Claude Code подключает управление сессиями Google Colab. Ассистент запускает вычисления на GPU или TPU и передаёт файлы в удалённую виртуальную машину.
Apache-2.0 ★ 5 обновлён 2026-10-16
claude mcp add --env COLAB_MCP_WORKDIR=<COLAB_MCP_WORKDIR> --env COLAB_MCP_DRIVE=<COLAB_MCP_DRIVE> --transport stdio colab-mcp-unofficial -- uvx colab-cli-mcpЧто делает Colab-MCP (unofficial)
Сервер связывает ИИ-клиент с официальной утилитой google-colab-cli. Ассистент создаёт и выключает удалённые среды, запускает длительные фоновые скрипты, считывает логи и выполняет локальные файлы .ipynb по ячейкам с сохранением состояния ядра между вызовами.
Инструмент работает только на macOS и Linux, так как базовый CLI от Google не поддерживает Windows. Доступна монтировка Google Drive прямо на удалённой виртуальной машине, причём авторизация выполняется пользователем в браузере без передачи паролей модели. Локальные операции изолированы в каталоге COLAB_MCP_WORKDIR, а секреты передаются в ядро напрямую без попадания в текст промпта.
Для работы требуются установленный менеджер пакетов uv и утилита google-colab-cli. Перед запуском необходимо один раз пройти авторизацию командой colab sessions в терминале. Вычисления тратят вычислительные единицы привязанного аккаунта Google.
Какие задачи решает
- запустить фоновый скрипт обучения модели на удалённом GPU
- пошагово выполнить ячейки ноутбука
.ipynbс сохранением переменных - загрузить директорию с кодом на виртуальную машину Colab
- примонтировать Google Drive к удалённой сессии без консоли
Примеры запросов агенту
- Создай сессию Colab с GPU T4 и проверь её статус
- Загрузи папку проекта на виртуальную машину и запусти
python -u train.pyв фоне - Выполни первые три ячейки в ноутбуке
experiment.ipynbи покажи вывод
Как установить Colab-MCP (unofficial)
Командой платформы
claude mcp add --env COLAB_MCP_WORKDIR=<COLAB_MCP_WORKDIR> --env COLAB_MCP_DRIVE=<COLAB_MCP_DRIVE> --transport stdio colab-mcp-unofficial -- uvx colab-cli-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from colab-cli-mcp <команда>
Командой платформы
codex mcp add colab-mcp-unofficial --env COLAB_MCP_WORKDIR=<COLAB_MCP_WORKDIR> --env COLAB_MCP_DRIVE=<COLAB_MCP_DRIVE> -- uvx colab-cli-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from colab-cli-mcp <команда>
Файл настроек
{
"mcpServers": {
"colab-mcp-unofficial": {
"command": "uvx",
"args": [
"colab-cli-mcp"
],
"env": {
"COLAB_MCP_WORKDIR": "<COLAB_MCP_WORKDIR>",
"COLAB_MCP_DRIVE": "<COLAB_MCP_DRIVE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from colab-cli-mcp <команда>
Файл настроек
{
"servers": {
"colab-mcp-unofficial": {
"type": "stdio",
"command": "uvx",
"args": [
"colab-cli-mcp"
],
"env": {
"COLAB_MCP_WORKDIR": "<COLAB_MCP_WORKDIR>",
"COLAB_MCP_DRIVE": "<COLAB_MCP_DRIVE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from colab-cli-mcp <команда>
Командой платформы
gemini mcp add -e COLAB_MCP_WORKDIR=<COLAB_MCP_WORKDIR> -e COLAB_MCP_DRIVE=<COLAB_MCP_DRIVE> colab-mcp-unofficial uvx colab-cli-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from colab-cli-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Colab-MCP (unofficial)
Как установить Colab-MCP (unofficial) в Claude Code?
Выполните команду claude mcp add colab-mcp -- uvx colab-cli-mcp.
Что делает Colab-MCP (unofficial)?
Предоставляет набор из 42 инструментов для создания сред Colab, выполнения кода, управления ячейками Jupyter-ноутбуков и обмена файлами с облачной машиной.
Что нужно для работы Colab-MCP (unofficial)?
Нужны macOS или Linux, утилита uv, пакет google-colab-cli и однократная авторизация через команду colab sessions.