koachgg/mcp-resume-server

MCP Server for Resume Submission

This is an MCP (Model Context Protocol) server implementation for submitting your resume to Puch AI.

Setup Instructions

1. Prerequisites

• Python 3.8 or higher
• Your resume file in one of these formats: PDF, DOCX, DOC, TXT, or MD

2. Installation

1. Create and activate a virtual environment:

python -m venv venv
.\venv\Scripts\Activate.ps1

2. Install dependencies:

pip install -r requirements.txt

3. Configuration

1. Update your application key: Replace <generated_token> in mcp_server.py with your actual application key from Puch.

2. Update your phone number: Replace 9189XXXXXXXX in mcp_server.py with your phone number in the format {country_code}{number} (without the + symbol).

   • Example: 919876543210 for an Indian number

3. Add your resume: Place your resume file in the same directory as mcp_server.py. The server will automatically detect files with these names:

   • resume.pdf, resume.docx, resume.doc, resume.txt, resume.md
   • cv.pdf, cv.docx, cv.doc, cv.txt, cv.md
   • Any file containing "resume" or "cv" in the filename

4. Running the Server

python mcp_server.py

The server will start on http://0.0.0.0:8085

5. Making the Server Publicly Accessible

For Puch to connect to your server, it needs to be publicly accessible. You can use:

• ngrok (recommended for testing):

  ngrok http 8085
  

  This will give you a public URL like https://abc123.ngrok.io

• Cloudflare Tunnel

• Your own VPS/cloud server

6. Connecting with Puch

Use the command:

/mcp connect <YOUR_PUBLIC_SERVER_URL>/mcp <YOUR_AUTH_TOKEN>

Example:

/mcp connect https://abc123.ngrok.io/mcp your_application_key_here

Features

The server implements three tools as required:

1. resume(): Returns your resume in markdown format
2. validate(): Returns your phone number for validation
3. fetch(): Fetches web content (utility tool)

Supported Resume Formats

• PDF: Extracts text using PyPDF2
• DOCX: Converts to markdown using mammoth (preferred) or docx2txt (fallback)
• DOC: Converts using docx2txt
• TXT: Reads as plain text
• MD: Reads as markdown

Troubleshooting

1. Resume not found: Make sure your resume file is in the same directory and has a recognizable name
2. Port in use: Change the port number in mcp_server.py if 8085 is already occupied
3. Import errors: Make sure all dependencies are installed with pip install -r requirements.txt

Security Note

This server uses a simple bearer token authentication. In production, consider implementing more robust authentication mechanisms.