jash0803/puch-mcp-server

🤖 Puch AI MCP Server

This project sets up a Model Context Protocol (MCP) server to connect with Puch AI. It validates your application key, phone number, and serves your resume in markdown format for use with LLMs.

🚀 Features

• ✅ Authentication via Puch Application Key
• 📎 Resume Tool (converts .pdf or .md to markdown)
• 🌐 URL Fetch Tool (simplifies or returns raw HTML)
• ☎️ Phone Number Validator
• 🧠 LLM-ready content formatting

📁 Project Structure

.
├── mcp_server.py         # Main MCP server
├── resume.pdf            # Your resume (can be .md or .pdf)
├── venv/                 # Virtual environment (recommended)
└── README.md             # You're reading it!

⚙️ Setup Instructions

1. Clone or Copy the Project

git clone <this-repo>
cd <project-folder>

2. Create a Virtual Environment

python -m venv venv
source venv/bin/activate       # macOS/Linux
venv\Scripts\activate          # Windows

3. Install Dependencies

pip install fastmcp pydantic openai readabilipy markdownify httpx pymupdf

🧠 Configuration

Edit mcp_server.py:

• Replace:

  TOKEN = "your_actual_application_key"
  MY_NUMBER = "91{your phone number}"
  

  with your actual application key and phone number (no + sign).

• Put your resume.pdf or resume.md in the same directory.

💾 Running the Server

python mcp_server.py

This will start your MCP server locally at http://localhost:8085.

🌍 Make It Public with Ngrok

Install ngrok (if not already):

npm install -g ngrok  # or brew install ngrok / download from ngrok.com

Start a tunnel:

ngrok http 8085

You'll get a public URL like:

https://abc123.ngrok.io

🤝 Connect with Puch

In your Puch DM/chat interface, run this command:

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

Replace:

• abc123.ngrok.io with your ngrok URL
• your_application_key with your real key

📎 Resume Tool Requirements

• Accepts a .md or .pdf file
• Converts content to raw markdown/text
• Returns plain LLM-friendly string
• Automatically included in server startup

🧪 Available MCP Tools

✅ Example Command to Fetch a URL

{
  "url": "https://example.com",
  "raw": false,
  "max_length": 3000
}

📄 Deactivate Virtual Environment

deactivate

📜 License

This project is part of the Puch AI application process and is intended for personal use.

🙋 Need Help?

If you run into issues, feel free to ping in Puch or check with the original instructions.