🍽️ Tekuila MCP Server
An MCP (Model Context Protocol) server for accessing Tekuila restaurant menus with AI-powered healthy meal recommendations.
Features
- 📅 Daily & Weekly Menus: Get current day and week menus from Tekuila restaurant
- 🤖 AI-Powered Analysis: Intelligent health recommendations and meal planning
- 📊 Date Context: Current date awareness for better planning
- 🌱 Health-Focused: Prioritizes vegetarian options while considering taste
- 🔧 Universal Compatibility: Works with Claude Desktop, Cursor, LM Studio, and other MCP clients
Quick Start
Prerequisites
- Python 3.12 or higher
- uv package manager
Installation
-
Clone and setup:
git clone <your-repo> cd tekuila uv sync -
Run the server:
For cloud hosting (HTTP transport):
uv run python main.pyFor local development (stdio transport):
uv run python tekuila.py
Transport Modes
The server supports two different transport modes:
Stdio Transport (tekuila.py)
- Use case: Local development and MCP client integration
- How it works: Communicates via standard input/output
- Best for: Claude Desktop, Cursor, LM Studio, and other MCP clients
- Command:
uv run python tekuila.py
HTTP Transport (main.py)
- Use case: Cloud hosting and web deployment
- How it works: Runs as an HTTP server on port 8000
- Best for: Cloud platforms, Docker containers, web services
- Command:
uv run python main.py - URL:
http://127.0.0.1:8000(when running locally)
Connect to MCP Clients
Claude Desktop
Add this to your claude_desktop_config.json (uses stdio transport):
{
"mcpServers": {
"tekuila": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/tekuila",
"run",
"tekuila.py"
]
}
}
}
Cursor
The server also works with Cursor's MCP integration. Configure it in your Cursor MCP settings.
LM Studio
Compatible with LM Studio's MCP server support. Add the server configuration in LM Studio's MCP settings.
Available Tools
Basic Menu Tools
get_current_day_menu()- Get today's menu with date contextget_current_week_menu()- Get this week's menu with date contextget_current_date()- Get current date and time context
AI-Powered Planning Tools
analyze_daily_menu()- Get today's menu with AI analysis instructionsplan_weekly_menu()- Get week's menu with planning guide
Prompts (for clients with prompt support)
analyze_menu_selection- AI-powered daily menu analysisweekly_menu_planning- AI-powered weekly meal planning
Usage Examples
Daily Menu Analysis
What's on the menu today at Tekuila?
Weekly Planning
Help me plan my meals for this week with healthy recommendations.
AI Analysis
Analyze today's menu and recommend the healthiest options.
Menu Structure
The server understands Finnish menu categories:
- 🌱 Vegaaninen kasvislounas - Vegan lunch (healthiest)
- 🥬 Kasvislounas - Vegetarian lunch (good option)
- 🍖 Lounas - Regular lunch (meat options)
- ⭐ POP UP Bistro - Special/expensive options
- 🍰 Jälkiruoka - Desserts
AI Analysis Features
Health Priority System
- Vegaaninen kasvislounas - Usually healthiest (vegan)
- Kasvislounas - Good vegetarian option
- Lounas - Regular meat option
- POP UP Bistro - Special/expensive option
Analysis Guidelines
- Nutritional Quality: Evaluates protein sources, vegetables, cooking methods
- Processing Level: Prefers whole foods over processed options
- Taste Balance: Considers if vegetarian options are actually appealing
- Value Assessment: Evaluates if special options are worth the cost
Red Flags
- Overly processed vegetarian options (like simple carrot crepes)
- Deep-fried items (paistettu)
- Heavy cream/cheese sauces (kerma, juusto)
- Lack of vegetables or protein
Technical Details
RSS Integration
- Current Day:
https://www.compass-group.fi/menuapi/feed/rss/current-day?costNumber=0605&language=fi - Current Week:
https://www.compass-group.fi/menuapi/feed/rss/current-week?costNumber=0605&language=fi
Dependencies
httpx- HTTP client for RSS fetchingmcp[cli]- Model Context Protocol server framework
Architecture
- Simple RSS Parsing: Extracts day + menu content
- AI-Powered Analysis: Lets AI analyze menu text intelligently
- Shared Instructions: Reuses prompt content across tools and prompts
- Date Awareness: Includes current date context for better planning
Development
Project Structure
tekuila/
├── tekuila.py # Main MCP server implementation (stdio transport)
├── main.py # HTTP server entry point (streamable-http transport)
├── pyproject.toml # Project configuration
├── uv.lock # Dependency lock file
├── .gitignore # Git ignore rules
└── README.md # This file
Running Tests
# Test HTTP server startup (cloud hosting)
uv run python main.py
# Test stdio server startup (local development)
uv run python tekuila.py
# Test individual functions
uv run python -c "from tekuila import get_current_date_context; print(get_current_date_context())"
Troubleshooting
Server Not Starting
- Check Python version (3.12+ required)
- Ensure all dependencies are installed:
uv sync - Check RSS feed URLs are accessible
License
This project is licensed under the MIT License - see the LICENSE file for details.
Enjoy your healthy meals at Tekuila! 🍽️