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

Uso

Iniciar el servidor:

npm start

Herramientas disponibles

obtener_menú_de_almuerzo

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

1. Acceda por SSH a su servidor Hetzner:

ssh root@your-server-ip

2. Instalar Docker si aún no está instalado:

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

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

4. Iniciar el servicio:

docker-compose up -d

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Basado en https://github.com/punkpeye/fastmcp-boilerplate