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
git clone <your-repo-url> cd mcp-serverInstall dependencies
npm installSet up environment variables Create a
.env.local
file in the root directory:# 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_passwordUpdate 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
accordinglyUse appropriate authentication credentials
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 -4243
- 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 -51151MIT 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 -29,125