python3 -m venv .venv or python -m venv .venv source .venv/bin/activate pip install --upgrade pip pip install -r requirements.txt .venv\Scripts\python.exe app.py

Локальный MCP + Groq + OpenAI Agents SDK

Этот учебный пример содержит:

• app.py: постоянный локальный Streamable HTTP MCP-сервер с несколькими инструментами.

• mcp_groq_agent.ipynb: агент, который находит и вызывает эти инструменты.

Настройка

Используйте Python 3.10 или новее. В терминале перейдите в папку проекта, создайте виртуальное окружение и установите всё необходимое и для сервера, и для блокнота (при необходимости замените python3.11 на актуальную команду вашего Python):

cd /Users/somenathmandal/Documents/transfer/grok-playground/MCP
python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Создайте .env из примера и укажите в нём ваш ключ API Groq:

cp .env.example .env

GROQ_API_KEY=replace_with_your_groq_key
GROQ_MODEL=openai/gpt-oss-20b

Никогда не фиксируйте и не распространяйте .env; он исключён через .gitignore.

Related MCP server: nit-mcp-server

Запуск MCP-сервера

Запустите MCP-сервер в одном терминале и оставьте его работать:

source .venv/bin/activate
.venv/bin/python app.py

Эндпоинт Streamable HTTP теперь доступен по адресу:

http://127.0.0.1:8000/mcp

Оставьте этот терминал открытым. Нажмите Ctrl+C, когда захотите остановить сервер.

Запуск блокнота с агентом

Во втором терминале:

cd /Users/somenathmandal/Documents/transfer/grok-playground/MCP
source .venv/bin/activate
jupyter lab mcp_groq_agent.ipynb

Если Jupyter запросит, выберите ядро Python .venv, затем выполните ячейки сверху вниз. Блокнот подключается напрямую к http://127.0.0.1:8000/mcp; он никогда не запускает и не импортирует app.py. Ключ API Groq загружается из .env и никогда не сохраняется в блокноте.

Как связаны компоненты

Notebook agent
    -> Groq OpenAI-compatible API (model reasoning and tool selection)
    -> http://127.0.0.1:8000/mcp (tool discovery and execution)
    -> app.py MCP tools

Сервер должен быть запущен до выполнения ячеек подключения к MCP. Если блокнот сообщает об ошибке соединения, сначала проверьте, что в терминале сервера указано, что Uvicorn работает на http://127.0.0.1:8000.

Блокнот также защищается от устаревших переменных окружения, указывающих на файлы сертификатов, которые иногда наследуются от средств запуска блокнотов. Переменная с сертификатом удаляется только в том случае, если указанный в ней путь не существует; корректные пользовательские настройки сертификатов сохраняются.

MCP