Canteen MCP

by c0dr
MIT License
44
  • Linux
  • Apple

Integrations

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

Kantine MCP

Ein Model Context Protocol (MCP)-Server, der über eine einfache API-Integration Zugriff auf das Mittagsmenü der Kantine bietet.

Beschreibung

Canteen MCP ist ein FastMCP-basierter Server, der ein Tool zum Abrufen täglicher Mittagsmenüs aus der Kantine bereitstellt. Es verbindet sich mit einer Menü-API und bietet eine strukturierte Schnittstelle zum Abfragen von Menüdaten für bestimmte Tage.

Merkmale

  • Holen Sie sich das Mittagsmenü für ein bestimmtes Datum
  • httpStream-basierter Transport für Echtzeitkommunikation
  • Umgebungsbasierte Konfiguration
  • Typsichere API mit Eingabevalidierung

Installation

npm install

Konfiguration

Kopieren Sie die Beispielumgebungsdatei und aktualisieren Sie sie mit Ihren Werten:

cp .env.example .env

Umgebungsvariablen

VariableBeschreibungBeispiel
API_URLURL der Mittagsmenü-APIhttps://lunch-menu-ai.vercel.app/api/v1/menu
HAFENPort für den MCP-Server8080
ENDPUNKTHTTP-Endpunkt/Endpunkt

Verwendung

Starten Sie den Server:

npm start

Verfügbare Tools

Mittagsmenü erhalten

Ruft das Mittagsmenü für ein bestimmtes Datum ab.

  • Parameter :
    • date : Zeichenfolge im Format JJJJ-MM-TT
  • Gibt zurück : JSON-Zeichenfolge mit den Menüdaten
  • Beispiel :
    const result = await tool.execute({ date: "2024-10-05" });

Entwicklung

Voraussetzungen

  • Node.js >= 18
  • npm

Ausführen im Entwicklungsmodus

npm run dev

Docker

Erstellen des Bildes

docker build -t canteen-mcp .

Ausführen des Containers

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

Verwenden der GitHub Container Registry

Rufen Sie das neueste Bild ab:

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

Einsatz

Bereitstellung für Hetzner

  1. Melden Sie sich per SSH bei Ihrem Hetzner-Server an:
ssh root@your-server-ip
  1. Installieren Sie Docker, falls es noch nicht installiert ist:
curl -fsSL https://get.docker.com | sh
  1. Erstellen Sie eine docker-compose.yml-Datei:
version: '3.8' services: canteen-mcp: image: ghcr.io/c0dr/canteen-mcp:latest restart: always ports: - "8080:3000" environment: - API_URL=your_api_url - PORT=3000 - ENDPOINT=/http
  1. Starten Sie den Dienst:
docker-compose up -d

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

Basierend auf 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.

Ein Model Context Protocol-Server, der über eine einfache API-Integration strukturierten Zugriff auf Kantinen-Mittagsmenüs für bestimmte Tage bietet.

  1. Beschreibung
    1. Merkmale
      1. Installation
        1. Konfiguration
          1. Umgebungsvariablen
        2. Verwendung
          1. Verfügbare Tools
        3. Entwicklung
          1. Voraussetzungen
          2. Ausführen im Entwicklungsmodus
        4. Docker
          1. Erstellen des Bildes
          2. Ausführen des Containers
          3. Verwenden der GitHub Container Registry
        5. Einsatz
          1. Bereitstellung für Hetzner
        6. Lizenz

          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
            105
            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