rishi02102017/puch-hackathon-mcp-server
If you are the rightful owner of puch-hackathon-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
The Puch AI Hackathon MCP Server is a TypeScript-based server designed for content creation and analysis, utilizing the Model Context Protocol (MCP) to provide robust tools for generating social media posts and summarizing content.
Career & Business Intelligence Suite - MCP Server
A powerful Model Context Protocol (MCP) server that provides AI-powered career and business intelligence tools for Puch AI.
🚀 Features
Career Tools
- Job Market Analyzer - Real-time job market trends and opportunities
- Resume Optimizer - ATS-friendly resume creation and optimization
- Salary Negotiator - Market-based salary insights and negotiation strategies
- Skill Gap Analyzer - Personalized learning recommendations
Business Tools
- Business Opportunity Finder - Market gap analysis and business opportunities
🛠️ Tech Stack
- Python 3.11+
- FastMCP - MCP server framework
- Pydantic - Data validation
- HTTPX - HTTP client
- Python-dotenv - Environment management
📋 Requirements
- Python 3.11 or higher
- Bearer token authentication (required by Puch AI)
- HTTPS deployment (required for production)
🚀 Quick Start
1. Clone the Repository
git clone <your-repo-url>
cd puch-ai-hackathon
2. Set Up Environment
Create a .env file in the project root:
AUTH_TOKEN=your_secret_token_here
MY_NUMBER=91xxxxxxxxxx
3. Install Dependencies
pip install fastmcp httpx python-dotenv pydantic
4. Run the Server
cd mcp-bearer-token
python career_business_mcp.py
The server will start on http://0.0.0.0:8086
🔗 Connect to Puch AI
- Deploy the server to a cloud platform (Render, Railway, etc.)
- Get your public HTTPS URL
- Connect using Puch AI:
/mcp connect https://your-deployed-url.com/mcp your_secret_token_here
🛠️ Available Tools
1. Job Market Analyzer
Analyzes real-time job market trends and opportunities.
- Input: Job title, location, industry
- Output: Market analysis, salary insights, trends
2. Resume Optimizer
Creates ATS-friendly resumes optimized for job applications.
- Input: Current resume, target job, experience
- Output: Optimized resume with ATS tips
3. Business Opportunity Finder
Identifies market gaps and business opportunities.
- Input: Industry, location, investment range
- Output: Market analysis and opportunity recommendations
4. Salary Negotiator
Provides market-based salary insights and negotiation strategies.
- Input: Job title, experience, location
- Output: Salary ranges and negotiation scripts
5. Skill Gap Analyzer
Analyzes skill gaps and provides personalized learning recommendations.
- Input: Current role, target role, skills, experience
- Output: Skill gap analysis and learning plan
🚀 Deployment
Render (Recommended)
- Connect your GitHub repository to Render
- Create a new Web Service
- Set build command:
pip install -r requirements.txt - Set start command:
cd mcp-bearer-token && python career_business_mcp.py - Add environment variables in Render dashboard
Railway
- Connect your GitHub repository to Railway
- Railway will auto-detect Python and deploy
- Add environment variables in Railway dashboard
Other Platforms
- Heroku - Use Procfile and requirements.txt
- DigitalOcean App Platform - Similar to Render setup
🔧 Environment Variables
| Variable | Description | Example |
|---|---|---|
AUTH_TOKEN | Secret token for authentication | xxxx_xxxxxxxxx_xxxx_xxxxxxx |
MY_NUMBER | Phone number in format {country_code}{number} | 91xxxxxxxxxx |
📝 API Endpoints
- MCP Endpoint:
/mcp/- Main MCP protocol endpoint - Health Check: Available through MCP protocol
🤝 Contributing
This project was built for the Puch AI Hackathon. Feel free to fork and extend!
📄 License
This project is licensed under the Apache 2.0 License.
🏆 Hackathon Project
Built for Puch AI Hackathon - "What's the coolest way you can build with AI?"
- Team: Jyotishman Das and Suvadip Chakraborty
- Project: Career & Business Intelligence Suite
- Hashtag: #BuildWithPuch