MCP Server Shop

Model Context Protocol (MCP) server that exposes product, cart, and order tools backed by our shop API at https://github.com/joefazee/learning-go-shop.

Prerequisites

• Go 1.24 or newer

Configuration

Set environment variables directly or via a .env file before starting the server:

• API_URL (default http://localhost:8080/api/v1)
• AUTH_TOKEN or JWT_TOKEN
• LOG_LEVEL (default debug)
• TRANSPORT (default stdio)

Run Locally

go run ./cmd/server

Using It With Claude Desktop

This is an example config for your Claude Desktop mcpServers settings:

{
  "mcpServers": {
    "shop": {
      "command": "mcp-server", // path to your binary
      "env": {
        "JWT_TOKEN": "",
        "API_URL": "http://localhost:8080/api/v1"
      }
    }
  }
}

Tooling Overview

The server registers toolsets for products, carts, and orders. They are surfaced over MCP streams so AI clients can browse products, manage carts, and review orders through the underlying REST API.