Canteen MCP

Canteen MCP

A Model Context Protocol (MCP) server that provides access to the canteen's lunch menu via a simple API integration.

Description

Canteen MCP is a FastMCP-based server that exposes a tool for retrieving daily lunch menus from the canteen. It connects to a menu API and provides a structured interface for querying menu data for specific dates.

Features

• Get lunch menu for any specific date
• httpStream-based transport for real-time communication
• Environment-based configuration
• Type-safe API with input validation

Installation

Configuration

Copy the example environment file and update it with your values:

Environment Variables

Usage

Start the server:

Available Tools

get_lunch_menu

Retrieves the lunch menu for a specific date.

• Parameters:
  • date: String in YYYY-MM-DD format
• Returns: JSON string containing the menu data
• Example:
  const result = await tool.execute({ date: "2024-10-05" });

Development

Prerequisites

• Node.js >= 18
• npm

Running in Development Mode

Docker

Building the Image

Running the Container

Using GitHub Container Registry

Pull the latest image:

Deployment

Deploying to Hetzner

1. SSH into your Hetzner server:

2. Install Docker if not already installed:

3. Create a docker-compose.yml file:

4. Start the service:

License

This project is licensed under the MIT License - see the LICENSE file for details.

Based on https://github.com/punkpeye/fastmcp-boilerplate