Merge branch 'main' of https://github.com/daniel7an/jobsearch-mcp-server; branch 'main' of https://huggingface.co/spaces/Agents-MCP-Hackathon/jobsearch-mcp-server

.gitattributes

@@ -17,4 +17,4 @@
 job_search_results.json -filter
 pyproject.toml -filter
 package.json -filter
-*.lock -filter 
+*.lock -filter 

README.md

@@ -1,213 +1,12 @@
 ---
-title: Job Search MCP Server
-emoji: 🔍
-colorFrom: blue
-colorTo: purple
+title: Jobsearch Mcp Server
+emoji: 📈
+colorFrom: pink
+colorTo: yellow
 sdk: gradio
-sdk_version: "5.0.0"
+sdk_version: 5.33.0
 app_file: app.py
 pinned: false
-license: mit
-tags:
-  - mcp-server-track
-  - job-search
-  - mcp
-  - ai-agents
-  - gradio
-  - embeddings
-  - cover-letter
-  - career
 ---
 
-# 🔍 Job Search MCP Server
-
-**Smart job matching and instant application helper** - A comprehensive MCP server that revolutionizes the job search process using GPU embeddings and LLM-powered assistance.
-
-## 🎯 Hackathon Entry - Track 1: MCP Server/Tool
-
-This project is submitted for the **Gradio Agents & MCP Hackathon 2025** under **Track 1: MCP Server/Tool**.
-
-**Tag:** `mcp-server-track`
-
-## 🚀 What It Does
-
-This MCP server provides 4 core endpoints that transform how people search and apply for jobs:
-
-### 📊 Core MCP Endpoints:
-
-1. **`profile.upsert`** - Store user résumé, skills, salary expectations, and career goals
-2. **`jobs.search`** - Pull fresh job posts, rank with GPU embeddings, return fit scores  
-3. **`letter.generate`** - Create personalized cover letters using LLM
-4. **`qa.reply`** - Draft concise answers to client questions
-
-## 🎬 Demo Video
-
-> **Note:** A demo video showing the MCP server in action with various MCP clients (Claude Desktop, Cursor, etc.) will be added here.
-
-## ✨ Key Features
-
-### 🧠 GPU-Powered Job Matching
-- **Sentence Embeddings**: Uses state-of-the-art transformer models to understand job descriptions and user profiles
-- **FAISS Vector Search**: Real-time similarity matching between user skills and job requirements
-- **Intelligent Ranking**: Returns jobs with personalized fit scores (0-100%)
-
-### 🤖 LLM-Enhanced Applications
-- **Smart Cover Letters**: Context-aware cover letter generation in multiple tones
-- **Interview Q&A**: Instant responses to common interview questions
-- **Career Guidance**: Personalized suggestions based on user profile
-
-### 📈 Efficiency Benefits
-- **80%+ Time Savings**: Automates the most tedious parts of job searching
-- **Quality Improvement**: Reduces copy-pasted applications with personalized content
-- **Better Matching**: AI-driven job-to-skill matching vs. keyword search
-
-## 🏗️ Architecture
-
-### GPU Processing (T4-small)
-- Embeds user profiles and job descriptions using sentence-transformers
-- Maintains FAISS index for real-time similarity search
-- Efficient vector operations for large job databases
-
-### LLM Integration
-- Supports multiple providers (OpenAI, Anthropic, etc.)
-- Optimized prompts for cover letters and Q&A responses
-- Average calls under 300 tokens for cost efficiency
-
-### MCP Protocol Implementation
-- Full MCP server capabilities using Gradio
-- RESTful API endpoints for all core functions
-- Stateful user profile management
-
-## 🛠️ Installation & Setup
-
-1. **Clone the repository:**
-```bash
-git clone <your-repo-url>
-cd jobsearch-mcp-server
-```
-
-2. **Install dependencies:**
-```bash
-uv sync
-```
-
-3. **Set up environment variables:**
-```bash
-# Create .env file with:
-OPENAI_API_KEY=your_openai_key
-ANTHROPIC_API_KEY=your_anthropic_key
-HUGGINGFACE_TOKEN=your_hf_token
-```
-
-4. **Run the server:**
-```bash
-uv run python app.py
-```
-
-## 📱 Usage Examples
-
-### 1. Profile Setup
-```python
-# Store user profile
-result = mcp_server.profile_upsert(
-    user_id="john_doe", 
-    profile_data={
-        "resume": "Full resume text...",
-        "skills": ["Python", "React", "Node.js"],
-        "salary_wish": "$80,000 - $120,000",
-        "career_goals": "Senior full-stack developer role"
-    }
-)
-```
-
-### 2. Job Search with AI Ranking
-```python
-# Find and rank jobs
-results = mcp_server.jobs_search(
-    user_id="john_doe",
-    query="Python developer",
-    location="Remote",
-    job_type="full-time"
-)
-# Returns jobs with 0-100% fit scores
-```
-
-### 3. Generate Cover Letter
-```python
-# Create personalized cover letter
-letter = mcp_server.letter_generate(
-    user_id="john_doe",
-    job_description="Job posting text...",
-    tone="professional"
-)
-```
-
-### 4. Interview Q&A Assistant
-```python
-# Get help with interview questions
-response = mcp_server.qa_reply(
-    user_id="john_doe",
-    question="Why should we hire you?",
-    context="Software engineering role"
-)
-```
-
-## 💻 Technology Stack
-
-- **Framework**: Gradio 5.0+ with MCP support
-- **Embeddings**: sentence-transformers, FAISS
-- **LLM**: OpenAI GPT/Anthropic Claude APIs  
-- **ML**: PyTorch, scikit-learn, pandas
-- **Web**: httpx, aiohttp, requests
-- **Data**: Beautiful Soup for job scraping
-
-## 🚀 Typical User Flow
-
-1. **One-time Setup**: Upload résumé and skills using `profile.upsert`
-2. **Job Discovery**: Search for roles with `jobs.search` (e.g., "LLM engineer")
-3. **Smart Ranking**: Get ranked list with AI-powered fit percentages
-4. **Quick Apply**: Generate cover letter with `letter.generate`
-5. **Interview Prep**: Use `qa.reply` for instant responses to recruiter questions
-
-## 🎯 Impact & Benefits
-
-- **For Job Seekers**: Reduces application time by 80%+, improves match quality
-- **For Recruiters**: Better-matched candidates, higher-quality applications
-- **For Platforms**: Enhanced user engagement, data-driven insights
-
-## 🏆 Innovation Highlights
-
-1. **Hybrid AI Approach**: Combines GPU embeddings with LLM generation for optimal cost/performance
-2. **MCP Integration**: Native MCP server that works with any MCP client
-3. **Real-time Processing**: Sub-second job ranking for thousands of postings
-4. **Contextual Understanding**: Deep semantic matching beyond keyword search
-
-## 🔧 MCP Client Integration
-
-This server works seamlessly with:
-- **Claude Desktop** (Anthropic)
-- **Cursor** IDE
-- **Custom Gradio Apps** as MCP clients
-- Any MCP-compatible application
-
-## 📊 Technical Specifications
-
-- **Python**: 3.10+
-- **Memory**: Optimized for efficient embedding storage
-- **GPU**: T4-small compatible, CPU fallback available
-- **API**: RESTful endpoints with full MCP protocol support
-- **Scalability**: Designed for production deployment
-
-## 🤝 Contributing
-
-This project is part of the Gradio Agents & MCP Hackathon 2025. Contributions and feedback are welcome!
-
-## 📄 License
-
-MIT License - see LICENSE file for details.
-
----
-
-**Built for the Gradio Agents & MCP Hackathon 2025** 🚀
-
-*Transforming job search through intelligent automation and AI-powered matching*
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference