Cantina MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso al menú de almuerzo del comedor a través de una sencilla integración de API.

Descripción

Canteen MCP es un servidor basado en FastMCP que ofrece una herramienta para recuperar los menús diarios del comedor. Se conecta a una API de menús y proporciona una interfaz estructurada para consultar los datos del menú en fechas específicas.

Related MCP server: MCP Apple Calendars

Características

Obtenga el menú del almuerzo para cualquier fecha específica
Transporte basado en httpStream para comunicación en tiempo real
Configuración basada en el entorno
API de tipo seguro con validación de entrada

Instalación

npm install

Configuración

Copie el archivo de entorno de ejemplo y actualícelo con sus valores:

cp .env.example .env

Variables de entorno

Variable	Descripción	Ejemplo
URL de API	URL de la API del menú del almuerzo	https://lunch-menu-ai.vercel.app/api/v1/menu
PUERTO	Puerto para el servidor MCP	8080
PUNTO FINAL	Punto final HTTP	/punto final

Uso

Iniciar el servidor:

npm start

Herramientas disponibles

Recupera el menú del almuerzo para una fecha específica.

Parámetros :
- date : cadena en formato AAAA-MM-DD
Devuelve : cadena JSON que contiene los datos del menú

Ejemplo :

const result = await tool.execute({ date: "2024-10-05" });

Desarrollo

Prerrequisitos

Node.js >= 18
npm

Ejecutando en modo de desarrollo

npm run dev

Estibador

Construyendo la imagen

docker build -t canteen-mcp .

Ejecución del contenedor

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

Uso del Registro de contenedores de GitHub

Extrae la última imagen:

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

Despliegue

Desplegando en Hetzner

Acceda por SSH a su servidor Hetzner:

ssh root@your-server-ip

Instalar Docker si aún no está instalado:

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

Cree un archivo docker-compose.yml:

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