Mohamedrazan/mcp-server-resume-chat

# MCP Server - Resume Chat + Safe Email

A **Flask-based Model Context Protocol (MCP) server** that:  

- Answers questions about a resume (JSON-based)  
- Sends safe email notifications (via Mailtrap sandbox or real SMTP)  
- Provides a simple frontend to chat and send emails  

---

## 🚀 Setup

1. **Clone the repository**  
```bash
git clone <your-repo-url>
cd mcp_server

2. Create a virtual environment (recommended)

python -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

4. Update SMTP credentials in app.py (optional)

• For safe testing: Mailtrap sandbox (already configured)
• For real email: Gmail SMTP using an App Password

USE_SANDBOX = True  # True = Mailtrap, False = Real SMTP

5. Run the server locally

python app.py

6. Open in browser http://127.0.0.1:5000/

🗂 Project Structure

mcp_server/
│── app.py             # Flask server
│── resume.json        # Resume data in JSON
│── templates/
│    ├── index.html    # Chat + email form
│    └── result.html   # Displays chat/email result
│── requirements.txt
│── README.md

💡 Usage

Chat About Resume

Ask questions like:

• "What is your experience?"
• "Where did you study?"
• "What skills do you have?"
• "Tell me about Flutter projects"

Send Email

Fill in Recipient, Subject, and Body, then click "Send Email".

Safe Mode: Emails are sent to Mailtrap sandbox by default, so no real inbox is affected.

🛠 Dependencies

• Python 3.10+
• Flask==2.3.3
• Optional (for fuzzy matching): rapidfuzz

📝 Notes

• JSON-based resume allows structured Q&A
• Full object search returns aligned, readable results
• Rate limiting added per IP for chat and email to prevent spam
• Easy to deploy on PythonAnywhere, Heroku, or Render