Skip to content

shuklaji28/MCP_Resume

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ MCP Resume Server

GitHub repo size GitHub last commit License

Welcome to the 🧠 MCP (Machine-Connectable Profile) Resume Server β€” a lightweight FastAPI-based server that exposes your professional profile in a structured, machine-readable format for Puch AI to read and process.

βœ… Designed to work with /mcp connect <url> <token> on Puch.
πŸ“¦ Built using: Python, FastMCP, pyngrok
🌐 Supports both local and public (ngrok) deployments


πŸ“Œ Key Features

  • πŸ“„ Serves your resume (base64-encoded) to /mcp endpoint
  • πŸ§‘β€πŸ’Ό Includes your name, headline, summary, LinkedIn, and GitHub links
  • βš™οΈ Simple config with .env
  • πŸ›°οΈ ngrok tunnel support for external access

πŸ› οΈ How It Works

The MCP server exposes a single GET endpoint:

πŸ“ Project Structure MCP_Resume/

  • β”œβ”€β”€ main.py # πŸš€ FastAPI server
  • β”œβ”€β”€ .env # πŸ” Secrets and settings
  • β”œβ”€β”€ ngrok.yml # 🌐 ngrok config (optional)
  • β”œβ”€β”€ resumes/
  • β”‚ └── resume.pdf # πŸ“„ Your actual resume
  • └── README.md # πŸ“˜ This file

βš™οΈ How to Run πŸ”§ Step 1: Clone and Install

git clone https://github.com/shuklaji28/MCP_Resume.git cd MCP_Resume pip install -r requirements.txt # or manually install: fastapi, uvicorn, pyngrok, python-dotenv

πŸ”§ Step 2: Configure .env PUCH_AUTH_TOKEN=your_token NGROK_AUTH_TOKEN=your_ngrok_token NGROK_PATH=C:\Users\your_user\Downloads\ngrok\ngrok.exe RESUME_PATH=resumes/resume.pdf PORT=8085

πŸ”§ Step 3: Start the server python main.py

You’ll see a tunnel URL like:

https://abc123.ngrok.io/ or https://7b3a-103-70-203-245.ngrok-free.app/mcp

πŸ“‘ Connect to Puch AI Paste the following into https://puch.ai interface:

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

πŸŽ‰ Boom! You’re now machine-connectable.

πŸ’‘ Tips

πŸ”’ Never upload .env publicly β€” it contains your secrets

🌍 You can inspect your /mcp output using: https://mcp.puch.ai/inspector

πŸ‘¨β€πŸ’» Author Shresth Shukla πŸ”— LinkedIn 🧠 Passionate about data engineering, AI integrations, and building cool stuff.

πŸ“œ License MIT License

⭐ If this project helped you get noticed, leave a star on the repo β€” it helps others discover it too!

About

A server that shares my resume in markdown format, fetches content from any url and shares that in text.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages