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 из примера и укажите в нём ваш ключ Groq API:

cp .env.example .env

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

Никогда не коммитьте и не передавайте .env; он исключён через .gitignore.

Related MCP server: Codex Harness MCP

Запуск 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. Ключ Groq API загружается из .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