Order MCP

Небольшой сквозной пример ассистента по заказам на базе Groq с использованием протокола Model Context Protocol (MCP).

Архитектура

Groq LLM -> MCP client -> MCP server -> REST order backend

• src/ai-client.ts отправляет вопрос пользователя в Groq и выступает в роли MCP-клиента.

• src/index.ts — это MCP-сервер, который предоставляет инструмент get_order_status через stdio.

• src/backend.ts — пример REST-бэкенда для заказов по адресу http://localhost:3000.

Related MCP server: commerce-ops-mcp

Обнаружение и вызов инструментов

После подключения к MCP-серверу клиент вызывает listTools(), чтобы обнаружить инструменты и их JSON-схемы. Он преобразует эти определения в функции-инструменты Groq и включает их в запрос к чату. Когда Groq возвращает вызов инструмента, клиент передаёт его имя и аргументы в callTool(). MCP-сервер обращается к REST-бэкенду, а клиент отправляет результат работы инструмента обратно в Groq для получения итогового ответа.

Установка и запуск

Требуется Node.js 20 или новее.

npm install

Укажите API-ключ Groq через переменную окружения GROQ_API_KEY. Не помещайте ключ в исходный код и не коммитьте его в Git.

Запустите REST-бэкенд в одном терминале:

npm run backend

Затем запустите клиент в другом терминале. Клиент запускается и автоматически подключается к MCP-серверу:

PowerShell:

$env:GROQ_API_KEY = "your-key"
npm run client

macOS/Linux:

export GROQ_API_KEY="your-key"
npm run client