🍽️ MCP Restaurant Ordering API Server

Welcome to the MCP-compatible Restaurant API built with Django + Django REST Framework.

Simulate customer orders from a dummy restaurant menu and track their status in real-time . Ideal for integration with any MCP server.

🧠 Why MCP Server?

We call this an MCP server because it follows the Model-Context-Protocol pattern:

• Model → The Order model defines the data structure (items, status, time).

• Context → Recent queries like /recent/?hours=2 give contextual insights (e.g., last 2 hours).

• Protocol → RESTful APIs define a structured communication protocol.

Think of it like a food court AI assistant:

🍔 Model = What's on the menu

⏰ Context = What's trending now

📡 Protocol = How it communicates with you (API)

This makes it ideal for plugging into larger AI/automation pipelines where structured data, temporal context, and clean APIs matter.

📁 Project Directory

├── mcp_server/
│   ├── requirements.txt
│   ├── db.sqlite3
│   ├── README.md
│   ├── .env
│   ├── manage.py
│   ├── orders/
│   │   ├── models.py
│   │   ├── serializers.py
│   │   ├── apps.py
│   │   ├── admin.py
│   │   ├── tests.py
│   │   ├── urls.py
│   │   └── views.py
│   ├── mcp_server/
│   │   ├── asgi.py
│   │   ├── settings.py
│   │   ├── urls.py
│   │   └── wsgi.py

🚀 Quickstart

# 1. Clone the repo
git clone https://github.com/sachnaror/restaurant-mcp-server.git
cd restaurant-mcp-server

# 2. Setup environment
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# 3. Add secrets to `.env`
echo "SECRET_KEY=your_django_secret_key" > .env
echo "DEBUG=True" >> .env

# 4. Run DB & server
python manage.py migrate
python manage.py runserver

🧪 Example Usage (cURL)

# Create a new order
curl -X POST http://localhost:8000/api/orders/ \
     -H "Content-Type: application/json" \
     -d '{"item_name": "Biryani", "status": "success"}'

# Get recent orders in last 2 hours
curl http://localhost:8000/api/orders/recent/?hours=2

🔌 API Endpoints

Base URL: http://localhost:8000/api/

🧠 Tech Stack

• 🐍 Python 3.11+

• 🧱 Django 5.x

• 🌐 Django REST Framework

• 📁 SQLite (Dev DB)

• 📦 python-dotenv

🏁 Roadmap (Ideas)

• 🔐 Token-based user authentication (optional)

• 📊 Dashboard for order analytics

• 📥 Webhook or async order processing simulation

• 🧠 OpenAI GPT integration for dynamic menu or chat

📸 Screenshots

📩 Contact