Столовая МКП

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

Описание

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

Related MCP server: MCP Apple Calendars

Функции

• Получить меню обеда на любую конкретную дату

• Транспорт на основе httpStream для общения в реальном времени

• Конфигурация на основе среды

• Типобезопасный API с проверкой входных данных

Установка

npm install

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

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

cp .env.example .env

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

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

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

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

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

ssh root@your-server-ip

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

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

3. Создайте файл 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. Запустить службу:

docker-compose up -d

Лицензия

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

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