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
- π Serves your resume (base64-encoded) to
/mcpendpoint - π§βπΌ Includes your name, headline, summary, LinkedIn, and GitHub links
- βοΈ Simple config with
.env - π°οΈ ngrok tunnel support for external access
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!