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
🛠️ Installation
- Clone the repository
- Install dependencies
- Set up environment variables
Create a
.env.local
file in the root directory: - Update resume data
Edit
data/resume.json
with your actual resume information.
🚀 Running the Application
Start the Next.js Frontend
Open http://localhost:3000 to view the application.
Start the MCP Server
📖 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 resumecontext
(string, optional): Additional context for the question
Example:
2. send_email
Sends email notifications.
Parameters:
recipient
(string, required): Email address of the recipientsubject
(string, required): Subject of the emailbody
(string, required): Body content of the emailfrom
(string, optional): Sender email address
Example:
🎯 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:
- Gmail Setup:
- Enable 2-factor authentication
- Generate an app password
- Use the app password in
SMTP_PASS
- Other Providers:
- Update
SMTP_HOST
,SMTP_PORT
, andSMTP_SECURE
accordingly - Use appropriate authentication credentials
- Update
Resume Data
Update data/resume.json
with your information:
- Personal information
- Work experience
- Education
- Skills
- Projects
- Certifications
🚀 Deployment
Frontend (Vercel)
MCP Server
The MCP server can be deployed as a standalone Node.js application or integrated into existing systems.
🤝 Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
📄 License
This project is licensed under the MIT License.
🆘 Troubleshooting
Common Issues
- MCP Server not starting:
- Check if all dependencies are installed
- Verify Node.js version compatibility
- Check console for error messages
- Resume chat not working:
- Verify OpenAI API key is set
- Check if resume data is loaded correctly
- Ensure MCP server is running
- 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
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables AI-powered conversations about resume/CV content and email notification sending through a comprehensive MCP server. Features a modern Next.js frontend with resume chat interface, email forms, and resume viewer for SE interview demonstrations.
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server for accessing NovaCV resume services API, enabling users to generate PDF resumes, analyze resume content, convert resume text to JSON format, and get available resume templates.Last updated -42973
- AsecurityAlicenseAqualityA Node.js/TypeScript MCP server that facilitates interactive communication between LLMs and users, allowing AI assistants to request user input, display notifications, and manage command-line chat sessions.Last updated -53311MIT License
- -securityAlicense-qualityA personal MCP Server that allows AI agents to retrieve your resume and contact you through Discord webhooks, deployable via Cloudflare Workers.Last updated -MIT License
- -securityFlicense-qualityEnables real-time communication between applications and AI models using the Model Context Protocol, supporting features like custom tools and multiple transport options for Next.js applications.Last updated -30,445