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.

Related MCP server: MCP Apple Calendars

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

Variable	Beschreibung	Beispiel
API_URL	URL der Mittagsmenü-API	https://lunch-menu-ai.vercel.app/api/v1/menu
HAFEN	Port für den MCP-Server	8080
ENDPUNKT	HTTP-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

Melden Sie sich per SSH bei Ihrem Hetzner-Server an:

ssh root@your-server-ip

Installieren Sie Docker, falls es noch nicht installiert ist:

curl -fsSL https://get.docker.com | sh

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