Локальный 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: MCP Python Server - Streamable HTTP

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

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

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

Теперь конечная точка Streamable HTTP доступна по адресу:

http://127.0.0.1:8000/mcp

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

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

Во втором терминale:

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.

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