Order MCP

Ein kleines End-to-End-Beispiel für einen Groq-gestützten Bestellassistenten, der das Model Context Protocol (MCP) verwendet.

Architektur

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

• src/ai-client.ts sendet die Benutzerfrage an Groq und fungiert als MCP-Client.

• src/index.ts ist der MCP-Server und stellt das get_order_status-Tool über stdio bereit.

• src/backend.ts ist ein Beispiel-REST-Backend für Bestellungen unter http://localhost:3000.

Related MCP server: commerce-ops-mcp

Tool-Erkennung und -Aufruf

Nach der Verbindung mit dem MCP-Server ruft der Client listTools() auf, um die Tools und ihre JSON-Schemas zu ermitteln. Er wandelt diese Definitionen in Groq-Funktionstools um und nimmt sie in die Chat-Anfrage auf. Wenn Groq einen Tool-Aufruf zurückgibt, übergibt der Client dessen Namen und Argumente an callTool(). Der MCP-Server ruft das REST-Backend auf, und der Client sendet das Tool-Ergebnis für die endgültige Antwort an Groq zurück.

Installation und Ausführung

Erfordert Node.js 20 oder höher.

npm install

Geben Sie einen Groq-API-Schlüssel über die Umgebungsvariable GROQ_API_KEY an. Fügen Sie den Schlüssel nicht in den Quellcode ein und committen Sie ihn nicht in Git.

Starten Sie das REST-Backend in einem Terminal:

npm run backend

Führen Sie dann den Client in einem anderen Terminal aus. Der Client startet und verbindet sich automatisch mit dem MCP-Server:

PowerShell:

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

macOS/Linux:

export GROQ_API_KEY="your-key"
npm run client