Job Search MCP Server

Instructions

Implementation Reference

• src/index.ts:128-158 (handler)

  The primary handler function for the 'search_ai_ml_jobs' tool. It extracts parameters from args, creates a JobFilter tailored for entry-level AI/ML jobs requiring Python, calls JobSearchService.searchAllSites, and returns the results as JSON text.

  private async searchAIMLJobs(args: any) {
    const {
      location = 'Remote',
      maxResults = 50,
      includeInternships = true,
      includeFullTime = true,
      keywords = []
    } = args;
  
    const filter: JobFilter = {
      location,
      maxResults,
      includeInternships,
      includeFullTime,
      keywords,
      experienceLevel: 'entry', // Less than 1 year
      requiredSkills: ['python'],
      jobTypes: ['ai', 'ml', 'machine learning', 'artificial intelligence', 'data science']
    };
  
    const results = await this.jobSearchService.searchAllSites(filter);
    
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(results, null, 2)
        }
      ]
    };
  }

• src/index.ts:40-71 (schema)

  JSON schema defining the input parameters for the 'search_ai_ml_jobs' tool, including location, maxResults, includeInternships, includeFullTime, and keywords.

  inputSchema: {
    type: 'object',
    properties: {
      location: {
        type: 'string',
        description: 'Job location (e.g., "Remote", "San Francisco, CA", "New York, NY")',
        default: 'Remote'
      },
      maxResults: {
        type: 'number',
        description: 'Maximum number of results to return',
        default: 50
      },
      includeInternships: {
        type: 'boolean',
        description: 'Include internship positions',
        default: true
      },
      includeFullTime: {
        type: 'boolean',
        description: 'Include full-time positions',
        default: true
      },
      keywords: {
        type: 'array',
        items: { type: 'string' },
        description: 'Additional keywords to search for (e.g., ["machine learning", "deep learning", "NLP"])',
        default: []
      }
    },
    required: []
  }

• src/index.ts:37-73 (registration)

  Registration of the 'search_ai_ml_jobs' tool in the tools list returned by ListToolsRequestSchema handler, including name, description, and input schema.

  {
    name: 'search_ai_ml_jobs',
    description: 'Search for AI/ML internships and full-time roles across multiple job sites',
    inputSchema: {
      type: 'object',
      properties: {
        location: {
          type: 'string',
          description: 'Job location (e.g., "Remote", "San Francisco, CA", "New York, NY")',
          default: 'Remote'
        },
        maxResults: {
          type: 'number',
          description: 'Maximum number of results to return',
          default: 50
        },
        includeInternships: {
          type: 'boolean',
          description: 'Include internship positions',
          default: true
        },
        includeFullTime: {
          type: 'boolean',
          description: 'Include full-time positions',
          default: true
        },
        keywords: {
          type: 'array',
          items: { type: 'string' },
          description: 'Additional keywords to search for (e.g., ["machine learning", "deep learning", "NLP"])',
          default: []
        }
      },
      required: []
    }
  },
  {

• src/services/jobSearchService.ts:19-50 (helper)

  Helper method in JobSearchService that performs parallel searches across all configured job scrapers (LinkedIn, Indeed, etc.) using the provided filter, aggregates results, and returns a comprehensive JobSearchResponse.

  async searchAllSites(filter: JobFilter): Promise<JobSearchResponse> {
    const startTime = Date.now();
    const results: JobSearchResult[] = [];
    
    // Search all sites in parallel
    const searchPromises = Array.from(this.scrapers.keys()).map(async (site) => {
      try {
        const result = await this.searchSite(site, filter);
        return result;
      } catch (error) {
        return {
          site,
          jobs: [],
          totalFound: 0,
          searchTime: 0,
          error: error instanceof Error ? error.message : 'Unknown error'
        };
      }
    });
  
    const searchResults = await Promise.all(searchPromises);
    results.push(...searchResults);
  
    const totalJobs = results.reduce((sum, result) => sum + result.jobs.length, 0);
  
    return {
      results,
      totalJobs,
      searchTimestamp: new Date().toISOString(),
      filters: filter
    };
  }