Order MCP

Un pequeño ejemplo de extremo a extremo de un asistente de pedidos impulsado por Groq que utiliza el Model Context Protocol (MCP).

Arquitectura

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

• src/ai-client.ts envía la pregunta del usuario a Groq y actúa como el cliente MCP.

• src/index.ts es el servidor MCP y expone la herramienta get_order_status a través de stdio.

• src/backend.ts es un backend REST de pedidos de ejemplo en http://localhost:3000.

Related MCP server: commerce-ops-mcp

Descubrimiento y llamada de herramientas

Después de conectarse al servidor MCP, el cliente llama a listTools() para descubrir las herramientas y sus esquemas JSON. Convierte esas definiciones en herramientas de función de Groq y las incluye en la solicitud de chat. Cuando Groq devuelve una llamada a herramienta, el cliente pasa su nombre y argumentos a callTool(). El servidor MCP llama al backend REST, y el cliente envía el resultado de la herramienta de vuelta a Groq para la respuesta final.

Instalación y ejecución

Requiere Node.js 20 o posterior.

npm install

Proporciona una clave de API de Groq a través de la variable de entorno GROQ_API_KEY. No pongas la clave en el código fuente ni la confirmes en Git.

Inicia el backend REST en una terminal:

npm run backend

Luego ejecuta el cliente en otra terminal. El cliente se inicia y se conecta al servidor MCP automáticamente:

PowerShell:

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

macOS/Linux:

export GROQ_API_KEY="your-key"
npm run client