MCP Resume Chat Server

# MCP Resume Chat Server A comprehensive Model Context Protocol (MCP) server application that can chat about your resume/CV and send email notifications. Perfect for SE interviews and showcasing MCP capabilities. ## 🚀 Features - **Resume Chat**: AI-powered chat interface that answers questions about your resume - **Email Notifications**: Send email notifications through the MCP server - **Modern Frontend**: Beautiful Next.js interface with dark mode support - **Well-Architected**: Clean folder structure with TypeScript support - **No Database Required**: Uses JSON files for data storage ## 📁 Project Structure ``` mcp-server/ ├── app/ # Next.js frontend │ ├── components/ # React components │ │ ├── ChatInterface.tsx # Resume chat interface │ │ ├── EmailForm.tsx # Email notification form │ │ └── ResumeViewer.tsx # Resume data viewer │ ├── api/ # API routes │ │ └── resume/ # Resume data endpoint │ └── page.tsx # Main application page ├── mcp-server/ # MCP server implementation │ ├── index.js # Main MCP server (JavaScript) │ └── index.ts # Main MCP server (TypeScript) ├── services/ # Business logic services │ ├── resumeParser.js/ts # Resume data parsing │ ├── resumeChatService.js/ts # AI chat functionality │ └── emailService.js/ts # Email sending service ├── config/ # Configuration files │ ├── email.ts # Email configuration │ └── mcp.ts # MCP server configuration ├── data/ # Data storage │ └── resume.json # Sample resume data ├── types/ # TypeScript type definitions │ └── index.ts # Core types and interfaces └── lib/ # Utility libraries ``` ## 🛠️ Installation 1. **Clone the repository** ```bash git clone <your-repo-url> cd mcp-server ``` 2. **Install dependencies** ```bash npm install ``` 3. **Set up environment variables** Create a `.env.local` file in the root directory: ```env # OpenAI API Key (required for resume chat) OPENAI_API_KEY=your_openai_api_key_here # Email Configuration (optional, for real email sending) SMTP_HOST=smtp.gmail.com SMTP_PORT=587 SMTP_SECURE=false SMTP_USER=your_email@gmail.com SMTP_PASS=your_app_password ``` 4. **Update resume data** Edit `data/resume.json` with your actual resume information. ## 🚀 Running the Application ### Start the Next.js Frontend ```bash npm run dev ``` Open [http://localhost:3000](http://localhost:3000) to view the application. ### Start the MCP Server ```bash # Using JavaScript version npm run mcp # Using TypeScript version (requires compilation) npm run dev:mcp ``` ## 📖 Usage ### 1. Resume Chat - Navigate to the "Resume Chat" tab - Ask questions about your resume like: - "What is my current position?" - "What companies have I worked for?" - "What are my main skills?" - "What was my last role?" ### 2. Email Notifications - Navigate to the "Email Notifications" tab - Use the quick templates or create custom emails - Configure SMTP settings for real email sending ### 3. Resume Viewer - Navigate to the "View Resume" tab - Browse through different sections of your resume - View formatted resume data ## 🔧 MCP Server Tools The MCP server exposes two main tools: ### 1. `resume_chat` Answers questions about resume/CV information. **Parameters:** - `question` (string, required): The question to ask about the resume - `context` (string, optional): Additional context for the question **Example:** ```json { "name": "resume_chat", "arguments": { "question": "What is my current position?", "context": "I'm preparing for an interview" } } ``` ### 2. `send_email` Sends email notifications. **Parameters:** - `recipient` (string, required): Email address of the recipient - `subject` (string, required): Subject of the email - `body` (string, required): Body content of the email - `from` (string, optional): Sender email address **Example:** ```json { "name": "send_email", "arguments": { "recipient": "recipient@example.com", "subject": "Interview Invitation", "body": "Thank you for your application...", "from": "sender@example.com" } } ``` ## 🎯 Interview Demo Script ### 1. Show the Architecture - Explain the clean folder structure - Highlight separation of concerns (services, config, types) - Show TypeScript usage for type safety ### 2. Demonstrate MCP Server - Start the MCP server: `npm run mcp` - Show the tools it exposes - Explain how it integrates with AI for resume chat ### 3. Frontend Features - Show the modern UI with tabs - Demonstrate resume chat functionality - Show email notification form - Display resume viewer with different sections ### 4. Technical Highlights - **No Database**: Uses JSON files for simplicity - **TypeScript**: Full type safety throughout - **Modern Stack**: Next.js 15, React 19, Tailwind CSS - **MCP Integration**: Proper Model Context Protocol implementation - **Error Handling**: Comprehensive error handling and user feedback ## 🔧 Configuration ### Email Setup (Optional) To enable real email sending: 1. **Gmail Setup:** - Enable 2-factor authentication - Generate an app password - Use the app password in `SMTP_PASS` 2. **Other Providers:** - Update `SMTP_HOST`, `SMTP_PORT`, and `SMTP_SECURE` accordingly - Use appropriate authentication credentials ### Resume Data Update `data/resume.json` with your information: - Personal information - Work experience - Education - Skills - Projects - Certifications ## 🚀 Deployment ### Frontend (Vercel) ```bash npm run build # Deploy to Vercel or your preferred platform ``` ### MCP Server The MCP server can be deployed as a standalone Node.js application or integrated into existing systems. ## 🤝 Contributing 1. Fork the repository 2. Create a feature branch 3. Make your changes 4. Add tests if applicable 5. Submit a pull request ## 📄 License This project is licensed under the MIT License. ## 🆘 Troubleshooting ### Common Issues 1. **MCP Server not starting:** - Check if all dependencies are installed - Verify Node.js version compatibility - Check console for error messages 2. **Resume chat not working:** - Verify OpenAI API key is set - Check if resume data is loaded correctly - Ensure MCP server is running 3. **Email sending fails:** - Verify SMTP configuration - Check email provider settings - Ensure app passwords are used for Gmail ### Getting Help - Check the console logs for detailed error messages - Verify all environment variables are set correctly - Ensure all dependencies are installed --- **Built with ❤️ for SE interviews and MCP demonstrations**