Canteen MCP

by c0dr
MIT License
42
  • Linux
  • Apple

Integrations

  • Connects to a lunch menu API hosted on Vercel to retrieve daily canteen meal information for specific dates

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
  • SSE-based transport for real-time communication
  • Environment-based configuration
  • Type-safe API with input validation

Installation

npm install

Configuration

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

cp .env.example .env

Environment Variables

VariableDescriptionExample
API_URLURL of the lunch menu APIhttps://lunch-menu-ai.vercel.app/api/v1/menu
PORTPort for the MCP server8080
SSE_ENDPOINTServer-sent events endpoint/sse

Usage

Start the server:

npm start

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

npm run dev

Docker

Building the Image

docker build -t canteen-mcp .

Running the Container

docker run -d \ -p 8080:3000 \ -e API_URL=your_api_url \ -e PORT=3000 \ -e SSE_ENDPOINT=/sse \ --name canteen-mcp \ canteen-mcp

Using GitHub Container Registry

Pull the latest image:

docker pull ghcr.io/[your-username]/canteen-mcp:latest

Deployment

Deploying to Hetzner

  1. SSH into your Hetzner server:
ssh root@your-server-ip
  1. Install Docker if not already installed:
curl -fsSL https://get.docker.com | sh
  1. Create a docker-compose.yml file:
version: '3.8' services: canteen-mcp: image: ghcr.io/[your-username]/canteen-mcp:latest restart: always ports: - "8080:3000" environment: - API_URL=your_api_url - PORT=3000 - SSE_ENDPOINT=/sse
  1. Start the service:
docker-compose up -d

License

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

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that provides structured access to canteen lunch menus for specific dates through a simple API integration.

  1. Description
    1. Features
      1. Installation
        1. Configuration
          1. Environment Variables
        2. Usage
          1. Available Tools
        3. Development
          1. Prerequisites
          2. Running in Development Mode
        4. Docker
          1. Building the Image
          2. Running the Container
          3. Using GitHub Container Registry
        5. Deployment
          1. Deploying to Hetzner
        6. License

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            Model Context Protocol server that provides seamless access to Google Calendar API with asynchronous operation support, enabling efficient calendar management through a standardized interface.
            Last updated -
            Python
            • Apple
            • Linux
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that provides seamless interaction with Workato's API through custom AI tools, enabling management of recipes, connections, connectors, folders, and activity logs.
            Last updated -
            TypeScript
            MIT License
            • Apple
            • Linux
          • A
            security
            A
            license
            A
            quality
            A Model Context Protocol server providing utility tools for development and testing, offering functionalities like personalized greetings, random card drawing, and datetime formatting with an extensible architecture.
            Last updated -
            19
            108
            2
            TypeScript
            MIT License
            • Apple
            • Linux
          • A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that provides tools for interacting with Gmail and Calendar APIs, enabling programmatic management of emails and calendar events.
            Last updated -
            8
            7
            JavaScript
            MIT License
            • Apple

          View all related MCP servers

          ID: kec2zuh2yo