Job Search MCP Server

An MCP (Model Context Protocol) server that searches across multiple job sites for AI/ML internships and full-time roles with specific filtering criteria.

Features

• Multi-site Job Search: Searches LinkedIn, Indeed, Glassdoor, ZipRecruiter, and Monster
• AI/ML Focus: Specifically targets artificial intelligence and machine learning positions
• Smart Filtering:
  • Filters for entry-level positions (less than 1 year experience)
  • Requires Python proficiency
  • Supports both internships and full-time roles
• Real-time Results: Gets the latest job postings from all sites
• Structured Data: Returns well-formatted job information with all relevant details

Installation

1. Clone or download this repository

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Usage

Running the Server

npm start

Or for development:

npm run dev

Available Tools

1. search_ai_ml_jobs

Search for AI/ML jobs across all supported job sites.

Parameters:

• location (string, optional): Job location (default: "Remote")
• maxResults (number, optional): Maximum results to return (default: 50)
• includeInternships (boolean, optional): Include internships (default: true)
• includeFullTime (boolean, optional): Include full-time roles (default: true)
• keywords (array, optional): Additional search keywords

Example:

{
  "location": "San Francisco, CA",
  "maxResults": 25,
  "includeInternships": true,
  "includeFullTime": true,
  "keywords": ["deep learning", "NLP", "computer vision"]
}

2. search_specific_job_site

Search for jobs on a specific job site.

Parameters:

• site (string, required): Job site ("linkedin", "indeed", "glassdoor", "ziprecruiter", "monster")
• location (string, optional): Job location (default: "Remote")
• maxResults (number, optional): Maximum results to return (default: 25)

Example:

{
  "site": "linkedin",
  "location": "Remote",
  "maxResults": 20
}

Job Filtering Criteria

The server automatically applies the following filters:

For Full-time Roles:

• Experience Level: Entry-level (less than 1 year experience)
• Required Skills: Must include Python proficiency
• Job Type: AI/ML related positions only

For Internships:

• Job Type: AI/ML related positions only
• Skills: Python proficiency preferred

AI/ML Keywords Detected:

• Machine Learning
• Artificial Intelligence
• Data Science
• Deep Learning
• NLP (Natural Language Processing)
• Computer Vision
• Neural Networks
• TensorFlow, PyTorch, Scikit-learn

Response Format

The server returns structured job data including:

{
  "results": [
    {
      "site": "LinkedIn",
      "jobs": [
        {
          "id": "unique_job_id",
          "title": "Machine Learning Engineer",
          "company": "Tech Company",
          "location": "San Francisco, CA",
          "type": "full-time",
          "experienceLevel": "entry",
          "description": "Job description...",
          "requirements": ["Python", "Machine Learning"],
          "skills": ["python", "tensorflow", "pytorch"],
          "postedDate": "2024-01-15T10:30:00Z",
          "applicationUrl": "https://...",
          "source": "LinkedIn",
          "isRemote": false,
          "hasPythonRequirement": true,
          "isAIMLRelated": true
        }
      ],
      "totalFound": 1,
      "searchTime": 1500
    }
  ],
  "totalJobs": 1,
  "searchTimestamp": "2024-01-15T10:30:00Z",
  "filters": {
    "location": "San Francisco, CA",
    "maxResults": 50,
    "includeInternships": true,
    "includeFullTime": true,
    "keywords": [],
    "experienceLevel": "entry",
    "requiredSkills": ["python"],
    "jobTypes": ["ai", "ml", "machine learning", "artificial intelligence", "data science"]
  }
}

Configuration

Copy env.example to .env and modify as needed:

cp env.example .env

Available configuration options:

• RATE_LIMIT_PER_MINUTE: Rate limiting for requests (default: 30)
• REQUEST_TIMEOUT: Request timeout in milliseconds (default: 30000)
• USER_AGENT: User agent string for web scraping

Supported Job Sites

1. LinkedIn - Professional networking and job board
2. Indeed - General job search engine
3. Glassdoor - Job search with company reviews
4. ZipRecruiter - Job matching platform
5. Monster - Traditional job board

Technical Details

• Language: TypeScript
• Runtime: Node.js
• Web Scraping: Cheerio for HTML parsing, Axios for HTTP requests
• Architecture: Modular scraper system with base class and site-specific implementations

Error Handling

The server includes comprehensive error handling:

• Network timeouts and connection errors
• HTML parsing errors
• Rate limiting protection
• Graceful degradation when individual sites fail

Legal and Ethical Considerations

This tool is for educational and personal use. Please respect:

• Website terms of service
• Rate limiting to avoid overloading servers
• Robots.txt files and scraping policies
• Consider using official APIs when available

Contributing

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Submit a pull request