🪐 Colab MCP (Model Context Protocol)

Сервер MCP (Model Context Protocol), который бесшовно связывает вашего локального ИИ-агента с сеансом Google Colab, запущенным в браузере.

✨ Возможности

• Подключает локальных ИИ-ассистентов напрямую к блокнотам Colab в браузере

• Поддерживает выполнение кода Python в Colab через агента

• Читает состояние блокнота Colab и взаимодействует с ним

Related MCP server: mcp-server-colab-exec

💻 Поддерживаемые клиенты

Для работы этого MCP-сервера требуется клиент, поддерживающий notifications/tools/list_changed, который должен быть запущен локально на вашем устройстве.

Популярные клиенты, соответствующие этим критериям:

• Gemini CLI

• Claude Code

• Windsurf

🚀 Установка и настройка

1. Установите uv (чрезвычайно быстрый установщик и резолвер пакетов Python):

   pip install uv

2. Настройте ваш MCP-клиент (например, в файле mcp.json или аналогичном конфигурационном файле):

   {
     "mcpServers": {
       "colab-mcp": {
         "command": "uvx",
         "args": ["git+https://github.com/googlecolab/colab-mcp"],
         "timeout": 30000
       }
     }
   }

   Примечание для сотрудников Google (или тех, кто использует нестандартные индексы пакетов): Возможно, вам потребуется добавить --index https://pypi.org/simple в массив args.

💬 Проблемы и обсуждения

Мы используем Discussions на GitHub в качестве основной площадки для обсуждения проблем и запросов на добавление функций.

По мере того как обсуждения перерастают в четкие задачи, сопровождающие будут преобразовывать их в отслеживаемые проблемы (issues). Этот рабочий процесс помогает нам гарантировать, что трекер проблем остается свободным от дубликатов, понятным и максимально ориентированным на действия.

⚠️ Пожалуйста, НЕ открывайте issues напрямую.

🤝 Участие в разработке

Хотя мы ценим интерес сообщества, в настоящее время у нас нет ресурсов для проверки внешних вкладов. Мы хотим избежать ситуации, когда Pull Requests от пользователей остаются без внимания, поэтому в данный момент мы не принимаем внешние вклады.

Если у вас есть отличная идея или вы столкнулись с проблемой, мы будем рады узнать об этом на нашей странице Discussions!

🛠️ Внутренняя информация (для разработчиков Colab)

Предварительные требования

• Требуется uv (pip install uv)

• Настройте git-хуки для запуска предварительных проверок репозитория:

  git config core.hooksPath .githooks

Настройка локальной разработки (Gemini CLI)

Чтобы протестировать вашу локальную версию с помощью Gemini CLI, используйте следующую конфигурацию:

{
  "mcpServers": {
    "colab-mcp": {
      "command": "uv",
      "args": ["run", "colab-mcp"],
      "cwd": "/path/to/github/colab-mcp",
      "timeout": 30000
    }
  }
}

MCP_Colab