Order MCP

Model Context Protocol(MCP)를 사용하는 Groq 기반 주문 어시스턴트의 간단한 엔드투엔드 예제입니다.

아키텍처

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

• src/ai-client.ts는 사용자 질문을 Groq에 보내고 MCP 클라이언트 역할을 합니다.

• src/index.ts는 MCP 서버이며 stdio를 통해 get_order_status 도구를 노출합니다.

• src/backend.ts는 http://localhost:3000에서 실행되는 샘플 REST 주문 백엔드입니다.

Related MCP server: commerce-ops-mcp

도구 검색 및 호출

MCP 서버에 연결한 후 클라이언트는 listTools()를 호출하여 도구와 해당 JSON 스키마를 검색합니다. 해당 정의를 Groq 함수 도구로 변환하여 채팅 요청에 포함합니다. Groq에서 도구 호출을 반환하면 클라이언트는 도구 이름과 인수를 callTool()에 전달합니다. MCP 서버는 REST 백엔드를 호출하고, 클라이언트는 최종 응답을 위해 도구 결과를 Groq에 다시 보냅니다.

설치 및 실행

Node.js 20 이상이 필요합니다.

npm install

GROQ_API_KEY 환경 변수를 통해 Groq API 키를 제공하세요. 키를 소스 코드에 넣거나 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