# 🍽️ MCP Restaurant Ordering API Server

![Python](https://img.shields.io/badge/python-3.11+-blue.svg)
![Django](https://img.shields.io/badge/django-5.x-green.svg)
![License](https://img.shields.io/badge/license-MIT-orange)
![Build](https://img.shields.io/badge/build-passing-brightgreen)

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/`

| Method   | Endpoint                          | Description                        | Sample Payload                             |
|----------|-----------------------------------|------------------------------------|--------------------------------------------|
| `POST`   | `/api/orders/`                    | 📝 Place a new order               | `{ "item_name": "Pizza", "status": "success" }` |
| `GET`    | `/api/orders/`                    | 📋 List all orders                 | –                                          |
| `GET`    | `/api/orders/{id}/`             | 🔍 Get single order by ID          | –                                          |
| `PUT`    | `/api/orders/{id}/`             | ✏️ Update an order                 | `{ "item_name": "Burger", "status": "failed" }` |
| `DELETE` | `/api/orders/{id}/`             | 🗑️ Delete an order                 | –                                          |
| `GET`    | `/api/orders/recent/?hours=2`     | ⏱️ Get orders from last 2 hours    | –                                          |

---

## 🧠 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

<img src="screenshots/11.png" width="600" height="400"/>

<img src="screenshots/12.png" width="600" height="400"/>

---

## 📩 Contact

| Name              | Details                             |
|------------------|-------------------------------------|
| **👨‍💻 Developer**  | Sachin Arora                        |
| **📧 Email**       | [sachnaror@gmail.com](mailto:sachnaror@gmail.com) |
| **📍 Location**    | Noida, India                        |
| **📂 GitHub**      | [github.com/sachnaror](https://github.com/sachnaror) |
| **🌐 Website**     | [https://about.me/sachin-arora](https://about.me/sachin-arora) |
| **📱 Phone**       | [+91 9560330483](tel:+919560330483) |

---