Столовая МКП

Сервер протокола контекста модели (MCP), который обеспечивает доступ к меню обедов столовой посредством простой интеграции API.

Описание

Canteen MCP — это сервер на базе FastMCP, который предоставляет инструмент для получения ежедневных меню обедов из столовой. Он подключается к API меню и предоставляет структурированный интерфейс для запроса данных меню на определенные даты.

Функции

Получить меню обеда на любую конкретную дату
Транспорт на основе httpStream для общения в реальном времени
Конфигурация на основе среды
Типобезопасный API с проверкой входных данных

Установка

npm install

Конфигурация

Скопируйте пример файла среды и обновите его, используя свои значения:

cp .env.example .env

Переменные среды

Переменная	Описание	Пример
API_URL	URL API меню обеда	https://lunch-menu-ai.vercel.app/api/v1/menu
ПОРТ	Порт для сервера MCP	8080
КОНЕЧНАЯ ТОЧКА	HTTP-конечная точка	/конечная точка

Использование

Запустите сервер:

npm start

Доступные инструменты

получить_меню_обеда

Возвращает меню обеда на определенную дату.

Параметры :
- date : строка в формате ГГГГ-ММ-ДД
Возвращает : строку JSON, содержащую данные меню.
Пример :
const result = await tool.execute({ date: "2024-10-05" });

Разработка

Предпосылки

Node.js >= 18
нпм

Работа в режиме разработки

npm run dev

Докер

Создание имиджа

docker build -t canteen-mcp .

Запуск контейнера

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

Использование реестра контейнеров GitHub

Извлеките последнее изображение:

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

Развертывание

Развертывание в Hetzner

Подключитесь по SSH к вашему серверу Hetzner:

ssh root@your-server-ip

Установите Docker, если он еще не установлен:

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

Создайте файл 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

Запустить службу:

docker-compose up -d

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

На основе https://github.com/punkpeye/fastmcp-boilerplate

Canteen MCP

Integrations