# FoodGen

En MCP-server som gjør en middagsforespørsel om til **handleliste + oppskrift** på en mobilvennlig side — klar til å lagres i Apple Notater.

> «Middag til 3 personer (2 voksne og 1 barn), rask før fotballtrening, ikke fisk.»

Claude finner retten, kaller `create_dinner_plan`, og svarer med en lenke som
`https://foodgen.instantoffr.com/n/Hxe7gVY_YYqRi2CCeZnV5g`. På mobilen:

- **Handleliste** gruppert etter butikk-avdeling, med avkryssing i butikken (huskes på enheten)
- **Oppskrift** med ingredienser og steg under
- **«Legg i Notater»** → delingsark → Notater lagrer alt som ett notat med punktliste
- `…/n/<id>.txt` gir ren tekst, `…/n/<id>.json` gir rådata

## Arkitektur

- **Node 24 + Express**, MCP over **Streamable HTTP** på `/mcp` (stateless — ingen sesjoner, alt ligger i SQLite)
- **SQLite** (`node:sqlite`, ingen native avhengigheter) i et Docker-volum
- Modellen skriver oppskriften; serveren validerer (zod), lagrer og publiserer
- Plan-URLer er 128-bit tilfeldige — ikke gjettbare, ikke indekserte; det er hele tilgangskontrollen

### MCP-flater

| | |
|---|---|
| `create_dinner_plan` | lagrer en full plan, returnerer lenken |
| `search` / `fetch` | ChatGPT-connector-kontrakten (søk + oppslag) |
| `get_dinner_plan` | leser en plan tilbake (id eller URL) |
| `list_recent_dinner_plans` | siste planer, nyest først |
| `delete_dinner_plan` | sletter en plan permanent |
| prompt `/middag` | «middag til … »-snarvei |

## Kjøring

```bash
cp .env.example .env      # sjekk PUBLIC_URL
docker compose up -d --build
```

TLS og proxy håndteres av Nginx Proxy Manager, som allerede kjører og er
konfigurert mot port `2400`. Én ting er verdt å sjekke på proxy-hosten:
MCP-svar strømmer som SSE, så bufring og 60-sekunders lese-timeout kan kutte
strømmen. Skru på **Websockets Support**, og legg eventuelt dette i
**Advanced**-fanen:

```nginx
location /mcp {
    proxy_pass http://$server:$port;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header Connection "";
    proxy_buffering off;
    proxy_cache off;
    proxy_read_timeout 3600s;
}
```

Lokal utvikling uten Docker:

```bash
PUBLIC_URL=http://localhost:2400 npm run dev
```

## Koble til Claude og ChatGPT

- **Claude-appen / claude.ai / Cowork**: Settings → Connectors → Add custom connector → `https://foodgen.instantoffr.com/mcp` (ingen autentisering)
- **Claude Code**: `claude mcp add --transport http foodgen https://foodgen.instantoffr.com/mcp`
- **ChatGPT**: Settings → Connectors → legg til egendefinert MCP-connector med samme adresse, ingen autentisering. Serveren eksponerer `search`/`fetch` etter OpenAI-kontrakten, så den fungerer som vanlig connector (søk/oppslag i lagrede middager og deep research); med **Developer mode** på kan ChatGPT også bruke `create_dinner_plan` og lage nye middager.

Forsiden på `https://foodgen.instantoffr.com` viser de samme instruksjonene.

## Test

```bash
docker compose up -d --build   # eller npm start
node test/e2e.mjs              # full MCP + HTTP-runde, 26 sjekker
```

## Miljøvariabler

| Variabel | Standard | |
|---|---|---|
| `PUBLIC_URL` | `https://foodgen.instantoffr.com` | Offentlig origin; lenkene bygges av denne |
| `PORT` | `2400` | HTTP-port inne i containeren |
| `BIND_ADDR` | `0.0.0.0` | Hvor compose publiserer porten |
| `DB_PATH` | `/app/data/foodgen.db` | SQLite-fil (volum) |
| `RETENTION_DAYS` | `0` | Slett planer eldre enn N dager (0 = aldri) |