О чём урок
Создайте сервер MCP для игры в крестики-нолики на базе Mistral, разверните его в Hugging Face Spaces и подключите его к Vibe, чтобы играть прямо из интерфейса чата.
В следующей таблице описаны пять шагов этого руководства:
Архитектура представляет собой цепочку от Vibe через ваш MCP сервер к игровой логике:
- Вы вводите "create a new tic-tac-toe game" в Vibe
- Vibe вызывает инструмент `create_room()` вашего MCP сервера
- Ваш сервер создает игровую сессию и возвращает доску
- Вы делаете ход — Vibe вызывает `make_move(position)`
- Ваш сервер обрабатывает ход, запрашивает у Mistral ответный ход
- Обновленная доска и немного "трэш-тока" от ИИ возвращаются
- Игра продолжается, пока кто-то не выиграет или не будет ничья
Для выполнения этого руководства вам понадобятся:
- Python 3.11+
- Аккаунт Mistral и API key
- Аккаунт Hugging Face с Pro подпиской (для развертывания Docker контейнера)
Сначала создайте Space, чтобы вы могли строить файлы вашего проекта непосредственно внутри клонированного репозитория.
- Перейдите на huggingface.co/new-space
- Назовите ваш Space (например, tictactoe-mcp-server)
- Выберите Docker в качестве SDK
- Установите видимость на Public (требуется для коннекторов Vibe)
Вам понадобится API key Mistral. В Studio перейдите в раздел API keys, выберите Private and shared connectors из выпадающего меню Connectors access scope и создайте новый ключ.
Добавьте ваш API key как секрет Space, чтобы он был доступен во время выполнения, не сохраняясь в репозитории:
- Перейдите на вкладку Settings вашего Space
- Прокрутите до Variables and secrets
- Нажмите New secret
- Установите имя MISTRAL_API_KEY и вставьте ваш API key в качестве значения
Секреты Space доступны только для записи — после сохранения значение нельзя прочитать со страницы настроек. Они внедряются как переменные окружения во время выполнения, поэтому os.getenv('MISTRAL_API_KEY') в вашем коде работает так же, как и с локальным файлом .env. Не коммитьте файл .env в ваш репозиторий.
Для клонирования и отправки в Hugging Face вам нужен User Access Token…
План урока
- Что вы создадите
- Как это работает
- Предварительные требования
- Настройка окружения
- Создание Hugging Face Space
- Необходимые переменные окружения
- Клонирование Space
- Установка
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.