Norish MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to the Norish recipe management API.

Connect your LLM client to your personal Norish instance for recipe browsing, meal planning, and grocery list management — all through a standardized MCP interface.

Features

This server exposes the following tools:

Recipes

Meal Planning

Grocery List

Stores

System

Related MCP server: MCP Boilerplate

Prerequisites

• Node.js v22+ or Docker Compose

• A running Norish instance with API access

• Your Norish NORISH_API_KEY (generate from your Norish account settings)

Setup

1. Clone and install dependencies

git clone <this-repo-url>
cd norish-mcp
npm install

2. Configure environment variables

Copy .env.example to .env and fill in the values:

cp .env.example .env

3. Build and run

Development mode:

npm run dev

Production build:

npm run build
npm start

The server starts on http://localhost:<PORT> with the MCP endpoint at POST /mcp.

Docker (Recommended)

The easiest way to run this server is with Docker Compose using the official image:

# docker-compose.yml
services:
  norish-mcp:
    image: ghcr.io/kellojo/norish-mcp:latest
    container_name: norish-mcp
    ports:
      - "3001:3001"
    env_file: .env

Create a .env file in the same directory:

NORISH_API_URL=https://your-norish-instance.com:6002
NORISH_API_KEY=your-api-key-here
MCP_API_KEY=your-secret-mcp-key
PORT=3001

Then start it:

docker compose up -d

The server will be available at http://localhost:3001 with the MCP endpoint at POST /mcp.

Running Directly

Pull and run without Docker Compose:

docker pull ghcr.io/kellojo/norish-mcp:latest

docker run -d \
  --name norish-mcp \
  -p 3001:3001 \
  --env-file .env \
  ghcr.io/kellojo/norish-mcp:latest

Building from Source

If you prefer to build locally:

docker compose build
docker compose up -d

Authentication

The server requires a Bearer token on every request:

Authorization: Bearer <MCP_API_KEY>

Requests without a valid token are rejected with a 401 Unauthorized error before reaching the MCP handler. This prevents unauthenticated access when exposing the server publicly.

Client Configuration

Claude Desktop (via mcp.json)

Add this to your Claude Desktop configuration (mcp.json):

{
  "mcpServers": {
    "norish": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "NORISH_API_URL": "https://your-norish-instance.com:6002",
        "NORISH_API_KEY": "<your-norish-api-key>",
        "MCP_API_KEY": "<your-mcp-api-key>"
      }
    }
  }
}

Other MCP Clients

For HTTP-based clients, point them to the server's endpoint with the auth header:

• URL: http://localhost:<PORT>/mcp

• Method: POST

• Headers: Authorization: Bearer <MCP_API_KEY>, Content-Type: application/json

License

MIT