The Canteen MCP server provides a structured API to retrieve daily lunch menus from a canteen.
- Retrieve Lunch Menus: Query the lunch menu for a specific date using the
get_lunch_menu
tool with a date string in 'YYYY-MM-DD' format - Data Format: Returns menu data as a JSON string
- Real-Time Communication: Utilizes httpStream-based transport for real-time data exchange
- Type-Safe API: Ensures input validation with a defined schema for query parameters
- Customizable Deployment: Can be configured and deployed via Docker, including support for GitHub Container Registry and Hetzner
- Environment-Based Configuration: Allows setting up API URLs, ports, and endpoints through environment variables
Connects to a lunch menu API hosted on Vercel to retrieve daily canteen meal information for specific dates
Canteen MCP
A Model Context Protocol (MCP) server that provides access to the canteen's lunch menu via a simple API integration.
Description
Canteen MCP is a FastMCP-based server that exposes a tool for retrieving daily lunch menus from the canteen. It connects to a menu API and provides a structured interface for querying menu data for specific dates.
Features
- Get lunch menu for any specific date
- httpStream-based transport for real-time communication
- Environment-based configuration
- Type-safe API with input validation
Installation
Configuration
Copy the example environment file and update it with your values:
Environment Variables
Variable | Description | Example |
---|---|---|
API_URL | URL of the lunch menu API | https://lunch-menu-ai.vercel.app/api/v1/menu |
PORT | Port for the MCP server | 8080 |
ENDPOINT | HTTP endpoint | /endpoint |
Usage
Start the server:
Available Tools
get_lunch_menu
Retrieves the lunch menu for a specific date.
- Parameters:
date
: String in YYYY-MM-DD format
- Returns: JSON string containing the menu data
- Example:
Development
Prerequisites
- Node.js >= 18
- npm
Running in Development Mode
Docker
Building the Image
Running the Container
Using GitHub Container Registry
Pull the latest image:
Deployment
Deploying to Hetzner
- SSH into your Hetzner server:
- Install Docker if not already installed:
- Create a docker-compose.yml file:
- Start the service:
License
This project is licensed under the MIT License - see the LICENSE file for details.
Based on https://github.com/punkpeye/fastmcp-boilerplate
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A Model Context Protocol server that provides structured access to canteen lunch menus for specific dates through a simple API integration.
Related MCP Servers
- -securityFlicense-qualityA proof-of-concept Model Context Protocol server that enables LLM applications to interact with Uber Eats, allowing AI agents to browse and order food through natural language.Last updated -193Python
- AsecurityFlicenseAqualityA Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.Last updated -219JavaScript
- AsecurityFlicenseAqualityA Model Context Protocol server for AI models to access and manipulate Apple Calendar data on macOS through a standardized interface.Last updated -76632TypeScript
- -securityFlicense-qualityA simple Model Context Protocol (MCP) server that provides date and time functionality in any timezone, along with user profiles and personalized greeting resources.Last updated -Python