Урок из полного доступа, первые уроки курса бесплатно Официальный курс Mistral AI Cookbook на русском
Урок 58 · Текст · ~5 мин

Свой MCP-сервер с крестиками-ноликами для Vibe

Урок 58 из 154 курса «Mistral AI Cookbook»: официальный курс Mistral AI Cookbook (Мистраль) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Создайте сервер MCP для игры в крестики-нолики на базе Mistral, разверните его в Hugging Face Spaces и подключите его к Vibe, чтобы играть прямо из интерфейса чата.

В следующей таблице описаны пять шагов этого руководства:

Архитектура представляет собой цепочку от Vibe через ваш MCP сервер к игровой логике:

  1. Вы вводите "create a new tic-tac-toe game" в Vibe
  2. Vibe вызывает инструмент `create_room()` вашего MCP сервера
  3. Ваш сервер создает игровую сессию и возвращает доску
  4. Вы делаете ход — Vibe вызывает `make_move(position)`
  5. Ваш сервер обрабатывает ход, запрашивает у Mistral ответный ход
  6. Обновленная доска и немного "трэш-тока" от ИИ возвращаются
  7. Игра продолжается, пока кто-то не выиграет или не будет ничья

Для выполнения этого руководства вам понадобятся:

  • Python 3.11+
  • Аккаунт Mistral и API key
  • Аккаунт Hugging Face с Pro подпиской (для развертывания Docker контейнера)

Сначала создайте Space, чтобы вы могли строить файлы вашего проекта непосредственно внутри клонированного репозитория.

  1. Перейдите на huggingface.co/new-space
  2. Назовите ваш Space (например, tictactoe-mcp-server)
  3. Выберите Docker в качестве SDK
  4. Установите видимость на Public (требуется для коннекторов Vibe)

Вам понадобится API key Mistral. В Studio перейдите в раздел API keys, выберите Private and shared connectors из выпадающего меню Connectors access scope и создайте новый ключ.

Добавьте ваш API key как секрет Space, чтобы он был доступен во время выполнения, не сохраняясь в репозитории:

  1. Перейдите на вкладку Settings вашего Space
  2. Прокрутите до Variables and secrets
  3. Нажмите New secret
  4. Установите имя MISTRAL_API_KEY и вставьте ваш API key в качестве значения

Секреты Space доступны только для записи — после сохранения значение нельзя прочитать со страницы настроек. Они внедряются как переменные окружения во время выполнения, поэтому os.getenv('MISTRAL_API_KEY') в вашем коде работает так же, как и с локальным файлом .env. Не коммитьте файл .env в ваш репозиторий.

Для клонирования и отправки в Hugging Face вам нужен User Access Token…

План урока

  1. Что вы создадите
  2. Как это работает
  3. Предварительные требования
  4. Настройка окружения
  5. Создание Hugging Face Space
  6. Необходимые переменные окружения
  7. Клонирование Space
  8. Установка

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы Mistral AI 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от Mistral AI (1 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Полезные гиды