WANehan923/MCP-Server

Nehan Chandira's CV MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to chat about Nehan Chandira's CV and send email notifications. This project showcases API design and integration skills through a practical implementation.

Features

CV Chat Functionality

• Intelligent CV Parsing: Structured data extraction from CV content
• Natural Language Queries: Ask questions like:
  • "What role did you have at your last position?"
  • "What are your technical skills?"
  • "Tell me about your latest projects"
  • "What is your educational background?"

Email Notification System

• SMTP Integration: Send emails through configurable email service
• Input Validation: Robust validation using Zod schemas
• Error Handling: Comprehensive error messages and status reporting
• HTML Email Templates: Professional email formatting

Next.js Playground

• Interactive Frontend: Test both CV chat and email functionality
• Modern UI: Clean, responsive design with Tailwind CSS
• Real-time Chat Interface: Simulated MCP server interactions
• Email Templates: Pre-built templates for common use cases

Technical Stack

• Backend: TypeScript, Node.js, MCP SDK
• Email Service: Nodemailer with Gmail/SMTP support
• Validation: Zod for schema validation
• Frontend: Next.js 14, React, Tailwind CSS
• Build Tools: TypeScript compiler, TSX for development

Prerequisites

• Node.js 18+ and npm
• Gmail account (for email functionality)
• MCP-compatible AI assistant (Claude Desktop, etc.)

Installation & Setup

1. Clone and Install Dependencies

# Navigate to project directory
cd "New MCP Serever"

# Install server dependencies
npm install

# Install frontend dependencies (optional)
cd frontend && npm install && cd ..

2. Configure Email Service

Create a .env file in the root directory:

EMAIL_USER=your-email@gmail.com
EMAIL_APP_PASSWORD=your-app-password

Email Setup Instructions:

1. Enable 2-factor authentication on your Gmail account
2. Generate an app-specific password:
   • Go to Google Account settings
   • Security → 2-Step Verification → App passwords
   • Generate password for "Mail"
3. Use the generated password as EMAIL_APP_PASSWORD

3. Build the Server

npm run build

Usage

As MCP Server

1. Start the server:

   npm start
   # or for development
   npm run dev
   

2. Configure in Claude Desktop (claude_desktop_config.json):

   {
     "mcpServers": {
       "nehan-cv-server": {
         "command": "node",
         "args": ["/path/to/New MCP Serever/dist/index.js"]
       }
     }
   }
   

3. Use in Claude Desktop:

   • Ask questions about Nehan's CV
   • Send emails through the MCP tools

Next.js Playground (Optional)

cd frontend
npm run dev

Visit http://localhost:3000 to access the interactive playground.

🔧 Available MCP Tools

cv_chat

Chat about Nehan's background and experience.

Parameters:

• question (string): Your question about CV content

Example:

{
  "question": "What programming languages does Nehan know?"
}

send_email

Send email notifications to specified recipients.

get_cv_topics

Get available CV topics you can ask about.

Parameters: None

email_service_info

Get email service configuration details.

Parameters: None

Live Deployment

Quick Deploy

Backend (MCP Server):

Frontend (Playground):

🔗 Expected Live URLs

After deployment, you'll have:

• Backend: https://your-app-name.railway.app
• Frontend: https://your-project.vercel.app

📖 Detailed deployment guide: See for step-by-step instructions

📞 Contact

• Email: nehanchandira619@gmail.com
• GitHub: WANehan923
• LinkedIn: nehancmp-bb7a43268

This project showcases technical proficiency in modern web development, API integration, and cloud-based solutions. Built as a demonstration of software engineering capabilities for potential employers and collaborators.