Kantine MCP

Name: Canteen MCP
Author: c0dr

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 API Service

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