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

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

2. Installieren Sie Docker, falls es noch nicht installiert ist:

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

3. 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

4. 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