Content
# 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
```sh
go run ./cmd/server
```
## Using It With Claude Desktop
This is an example config for your Claude Desktop `mcpServers` settings:
```json
{
"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.
