QPEL.ai

Установка Python и настройка виртуальных окружений

Курс: MCP: Создание ИИ-агентов на практике (Python & TypeScript)12+

Вы уже видели, как ИИ-агенты могут автоматизировать рутину, помогать в разработке и даже становиться основой новых продуктов. Теперь мы переходим от теории к практике — и первый шаг на этом пути — подготовка стабильной и надёжной среды разработки.

Именно от правильной настройки окружения зависит, насколько быстро и без ошибок вы сможете запускать свои MCP-серверы. Сегодня мы установим Python и настроим изолированное виртуальное окружение — это фундамент, на котором будет строиться ваш первый ИИ-агент.

Установка Python

Первое, что нам нужно, — это сам Python. Для разработки MCP-серверов подойдёт Python 3.10 или новее.

Проверьте, установлена ли у вас подходящая версия. Откройте терминал и выполните:

python --version

или, в зависимости от системы:

python3 --version

Если вы видите версию Python 3.10 или выше — отлично, можно продолжать. Если нет, перейдите на официальный сайт Python и скачайте установщик для вашей операционной системы.

Важно: При установке на Windows обязательно отметьте галочку "Add Python to PATH". Это позволит запускать Python из любого места в терминале.

Зачем нужно виртуальное окружение

Представьте: вы начинаете проект на FastAPI, и он требует версию fastapi==0.100. Через неделю вы запускаете второй проект, которому нужна fastapi==0.90. Если устанавливать пакеты глобально, новая версия перезапишет старую — и один из проектов перестанет работать.

Виртуальное окружение — это изолированная копия Python и его библиотек, созданная специально для одного проекта. Оно позволяет:

  • Устанавливать нужные версии пакетов для каждого проекта отдельно
  • Избежать конфликтов между зависимостями
  • Легко передавать или разворачивать проект на другом компьютере

Создание виртуального окружения с помощью venv

Python включает встроенную утилиту — venv — для создания виртуальных окружений. Это простой, надёжный и официально поддерживаемый способ.

Создадим окружение для нашего будущего MCP-сервера. В терминале перейдите в папку проекта и выполните:

python -m venv mcp_env

Здесь:

  • mcp_env — имя папки с окружением (можете выбрать другое)
  • venv — модуль Python, отвечающий за создание окружений

После выполнения команды появится папка mcp_env, содержащая копию интерпретатора, библиотек и служебных файлов.

Активация и деактивация окружения

Чтобы начать использовать виртуальное окружение, его нужно активировать.

Для Windows:

mcp_env\Scripts\activate

Для macOS и Linux:

source mcp_env/bin/activate

После активации вы увидите имя окружения в начале строки терминала:

(mcp_env) $

Теперь все команды pip будут устанавливать пакеты только в это окружение.

Чтобы выйти из окружения, выполните:

deactivate

Совет: Не забывайте активировать окружение каждый раз, когда работаете с проектом. Это частая ошибка — установить пакеты, забыв активировать venv, и получить их в глобальной системе.

Управление зависимостями

Управление зависимостями — это процесс отслеживания, какие библиотеки и в каких версиях использует проект. Это критически важно для воспроизводимости и стабильности.

Установим первую зависимость — fastapi, который мы будем использовать для создания MCP-сервера:

pip install fastapi

Теперь зафиксируем установленные пакеты в файле requirements.txt:

pip freeze > requirements.txt

Команда pip freeze выводит список всех установленных пакетов с версиями. Перенаправление > сохраняет этот список в файл.

Содержимое requirements.txt будет примерно таким:

fastapi==0.104.1
starlette==0.32.1

Этот файл — ваш "рецепт" для воссоздания окружения. Другой разработчик (или вы сами на другом компьютере) сможет установить всё одной командой:

pip install -r requirements.txt

Практическое задание

Выполните следующие шаги:

  1. Убедитесь, что у вас установлен Python 3.10+
  2. Создайте папку для проекта и перейдите в неё
  3. Создайте виртуальное окружение: python -m venv mcp_env
  4. Активируйте его (в зависимости от ОС)
  5. Установите FastAPI: pip install fastapi
  6. Зафиксируйте зависимости: pip freeze > requirements.txt
  7. Проверьте, что файл requirements.txt появился и содержит fastapi

Проверьте себя:

  • Установлен ли Python нужной версии?
  • Активировано ли окружение перед установкой пакета?
  • Есть ли файл requirements.txt с актуальным списком?

Если всё сделано — вы успешно настроили изолированную среду для разработки MCP-сервера. Это первый шаг к созданию работающего ИИ-агента.

Что дальше?

Теперь, когда вы освоили настройку окружения на Python, в следующей теме мы сделаем то же самое для TypeScript. Вы установите Node.js и научитесь управлять зависимостями с помощью npm — это понадобится для создания MCP-сервера на JavaScript-стеке.

Каждый шаг приближает вас к тому, чтобы уже завтра запустить своего первого ИИ-агента.

Готовы продолжить? 🚀