# kraenhansen/nemlig-mcp architecture

> Architecture diagram of the GitHub repository kraenhansen/nemlig-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kraenhansen/nemlig-mcp
- Repository: https://github.com/kraenhansen/nemlig-mcp

## Overview

nemlig-mcp is a local stdio MCP server that exposes a curated set of grocery-shopping and order-history tools over the nemlig_cli library. A user invokes a tool; the server validates or bounds inputs, the client supplies fresh authentication and calls the corresponding CLI function, and selected basket and order responses pass through privacy scrubbing before return. Batch basket updates run sequentially with retries and report per-item outcomes. The README documents the upstream CLI’s API responsibilities; its internals are not part of this repository.

Main entry points: [`src/nemlig_mcp/server.py`](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py) (Tool server), [`src/nemlig_mcp/client.py`](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/client.py) (Authenticated client), [`src/nemlig_mcp/privacy.py`](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/privacy.py) (Privacy scrubber), [`src/nemlig_mcp/_compat.py`](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/_compat.py) (Output shim)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["MCP interface"]
  node_server["Tool server<br/>[server.py]"]
end

subgraph group_shopping["Product and basket"]
  node_search["Product search<br/>[server.py]"]
  node_details["Product details<br/>[server.py]"]
  node_basket_read["Read basket<br/>[server.py]"]
  node_basket_write["Set quantity<br/>[server.py]"]
  node_basket_batch["Batch quantities<br/>[server.py]"]
end

subgraph group_orders["Order history"]
  node_history["Order history<br/>[server.py]"]
  node_order_details["Order details<br/>[server.py]"]
end

subgraph group_runtime["Client and privacy"]
  node_client["Authenticated client<br/>[client.py]"]
  node_compat["Output shim<br/>[_compat.py]"]
  node_privacy["Privacy scrubber<br/>[privacy.py]"]
end

node_user(("MCP user"))
node_cli["nemlig_cli library"]
node_nemlig_api{{"Nemlig API"}}

node_user -->|"calls tools"| node_server
node_server -->|"registers"| node_search
node_server -->|"registers"| node_details
node_server -->|"registers"| node_basket_read
node_server -->|"registers"| node_basket_write
node_server -->|"registers"| node_basket_batch
node_server -->|"registers"| node_history
node_server -->|"registers"| node_order_details
node_search -->|"calls"| node_client
node_details -->|"calls"| node_client
node_basket_read -->|"calls"| node_client
node_basket_write -->|"calls"| node_client
node_basket_batch -->|"calls"| node_client
node_history -->|"calls"| node_client
node_order_details -->|"calls"| node_client
node_client -->|"invokes API functions"| node_cli
node_client -->|"redirects output"| node_compat
node_basket_read -->|"scrubs response"| node_privacy
node_basket_write -->|"scrubs response"| node_privacy
node_basket_batch -->|"scrubs response"| node_privacy
node_history -->|"scrubs response"| node_privacy
node_order_details -->|"scrubs response"| node_privacy
node_cli -.->|"accesses endpoints"| node_nemlig_api

click node_server "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py"
click node_search "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py"
click node_details "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py"
click node_basket_read "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py"
click node_basket_write "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py"
click node_basket_batch "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py"
click node_history "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py"
click node_order_details "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py"
click node_client "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/client.py"
click node_compat "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/_compat.py"
click node_privacy "https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/privacy.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_user toneBlue
class node_search,node_details,node_basket_read,node_basket_write,node_basket_batch toneAmber
class node_history,node_order_details,node_nemlig_api toneMint
class node_client,node_compat,node_privacy toneRose
class node_cli toneIndigo
```

## Components

### MCP interface

- [Tool server](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py): `src/nemlig_mcp/server.py`

### Product and basket

- [Product search](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py): `src/nemlig_mcp/server.py`
- [Product details](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py): `src/nemlig_mcp/server.py`
- [Read basket](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py): `src/nemlig_mcp/server.py`
- [Set quantity](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py): `src/nemlig_mcp/server.py`
- [Batch quantities](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py): `src/nemlig_mcp/server.py`

### Order history

- [Order history](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py): `src/nemlig_mcp/server.py`
- [Order details](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/server.py): `src/nemlig_mcp/server.py`

### Client and privacy

- [Authenticated client](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/client.py): `src/nemlig_mcp/client.py`
- [Output shim](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/_compat.py): `src/nemlig_mcp/_compat.py`
- [Privacy scrubber](https://github.com/kraenhansen/nemlig-mcp/blob/main/src/nemlig_mcp/privacy.py): `src/nemlig_mcp/privacy.py`

### Other components

- **MCP user**
- **nemlig_cli library**
- **Nemlig API**

## Connections

- MCP user → Tool server: calls tools (evidence: `README.md`)
- Tool server → Product search: registers (evidence: `src/nemlig_mcp/server.py`)
- Tool server → Product details: registers (evidence: `src/nemlig_mcp/server.py`)
- Tool server → Read basket: registers (evidence: `src/nemlig_mcp/server.py`)
- Tool server → Set quantity: registers (evidence: `src/nemlig_mcp/server.py`)
- Tool server → Batch quantities: registers (evidence: `src/nemlig_mcp/server.py`)
- Tool server → Order history: registers (evidence: `src/nemlig_mcp/server.py`)
- Tool server → Order details: registers (evidence: `src/nemlig_mcp/server.py`)
- Product search → Authenticated client: calls (evidence: `src/nemlig_mcp/server.py`)
- Product details → Authenticated client: calls (evidence: `src/nemlig_mcp/server.py`)
- Read basket → Authenticated client: calls (evidence: `src/nemlig_mcp/server.py`)
- Set quantity → Authenticated client: calls (evidence: `src/nemlig_mcp/server.py`)
- Batch quantities → Authenticated client: calls (evidence: `src/nemlig_mcp/server.py`)
- Order history → Authenticated client: calls (evidence: `src/nemlig_mcp/server.py`)
- Order details → Authenticated client: calls (evidence: `src/nemlig_mcp/server.py`)
- Authenticated client → nemlig_cli library: invokes API functions (evidence: `src/nemlig_mcp/client.py`)
- Authenticated client → Output shim: redirects output (evidence: `src/nemlig_mcp/client.py`)
- Read basket → Privacy scrubber: scrubs response (evidence: `src/nemlig_mcp/server.py`)
- Set quantity → Privacy scrubber: scrubs response (evidence: `src/nemlig_mcp/server.py`)
- Batch quantities → Privacy scrubber: scrubs response (evidence: `src/nemlig_mcp/server.py`)
- Order history → Privacy scrubber: scrubs response (evidence: `src/nemlig_mcp/server.py`)
- Order details → Privacy scrubber: scrubs response (evidence: `src/nemlig_mcp/server.py`)
- nemlig_cli library → Nemlig API: accesses endpoints (evidence: `README.md`)
