# Cafeteria MCP

Configurable MCP server for cafeteria menu lookup.

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/skax-joonho-park/cafeteria-mcp.git)

The server exposes a single MCP tool, `get_cafeteria_menu`, and supports stdio plus HTTP/SSE transports.

## Configuration

Set these environment variables in your runtime or hosting provider:

```text
CAFETERIA_API_URL=<form-post-api-url>
CAFETERIA_CAMPUS=<campus-code>
CAFETERIA_SEQ=<cafeteria-sequence>
CAFETERIA_ORIGIN=<optional-origin-header>
CAFETERIA_SKIP_TLS_VERIFY=false
MCP_TRANSPORT=http
```

`CAFETERIA_ORIGIN` is optional. When omitted, the origin is derived from `CAFETERIA_API_URL`.
The upstream request is sent as `POST` with query parameters and `Content-Length: 0`.
Set `CAFETERIA_SKIP_TLS_VERIFY=true` only when the upstream cafeteria API requires curl-style `-k` behavior.

## Tool

`get_cafeteria_menu`

- `ymd`: lookup date, `YYYYMMDD` or `YYYY-MM-DD`. Defaults to today in Asia/Seoul.
- `mealType`: `LN` for lunch, `DN` for dinner.

## Local stdio

```bash
npm start
```

MCP client example:

```json
{
  "mcpServers": {
    "cafeteria": {
      "command": "node",
      "args": [
        "/absolute/path/to/src/server.mjs"
      ]
    }
  }
}
```

## HTTP/SSE

```bash
MCP_TRANSPORT=http PORT=3333 npm start
```

- Health check: `GET http://127.0.0.1:3333/health`
- MCP SSE: `GET http://127.0.0.1:3333/sse`
- MCP SSE message post: `POST http://127.0.0.1:3333/messages?sessionId=...`
- MCP JSON-RPC test endpoint: `POST http://127.0.0.1:3333/mcp`

Hosting environments that provide `PORT` automatically run the HTTP/SSE transport.

## Render

Deploy the repository with the included `render.yaml` Blueprint.

After deployment, set the required secret environment variables in Render. The public MCP SSE URL will be:

```text
https://<render-service-name>.onrender.com/sse
```

See [outputs/render-sse-mcp.md](outputs/render-sse-mcp.md) for a short registration note.

## Supabase Probe

This repository also includes a Supabase Edge Function probe at `supabase/functions/cafeteria-probe`.
Use it before porting the MCP server to confirm whether the Supabase runtime can reach the cafeteria API.

Required Supabase secrets:

```text
CAFETERIA_API_URL
CAFETERIA_CAMPUS
CAFETERIA_SEQ
CAFETERIA_ORIGIN
```

Probe URLs after deployment:

```text
https://<project-ref>.functions.supabase.co/cafeteria-probe?target=google
https://<project-ref>.functions.supabase.co/cafeteria-probe?target=cafeteria&ymd=20260608&mealType=LN
```

## Supabase MCP

The Supabase Edge Function MCP endpoint is available at:

```text
https://<project-ref>.functions.supabase.co/cafeteria-mcp
```

It supports MCP JSON-RPC methods including `initialize`, `tools/list`, and `tools/call`.

## Tests

```bash
npm run test:sse
npm run test:mcp
npm run test:api -- 20260608 LN
```

`test:api` requires the environment variables above.