mcp-jobs logo

mcp-jobs

by mergedao

mcp-jobs is a multi-platform job aggregation service based on the MCP (Model-Controller-Provider) architecture. It supports fetching job information from mainstream recruitment websites to provide structured job data for large models.

View on GitHub

Last updated: N/A

What is mcp-jobs?

mcp-jobs is a service that aggregates job postings from multiple platforms like Liepin, BOSS Zhipin, Zhilian Recruitment, and 51job, providing a unified and structured data format for use with large language models.

How to use mcp-jobs?

The service can be run temporarily via npx or installed globally or within a project using npm, yarn, or pnpm. It requires an API key, which needs to be set as an environment variable. Configuration instructions are provided for various AI clients like Cursor, Claude Desktop, Windsurf, and Cline.

Key features of mcp-jobs

  • Multi-platform data aggregation

  • Unified data format

  • Flexible search conditions

  • Real-time data update

  • Structured output

Use cases of mcp-jobs

  • Searching for frontend developer jobs in Shanghai

  • Finding data analyst positions in Beijing with 3+ years of experience

  • Identifying the highest-paying product manager jobs in Hangzhou

  • Integrating job data into large language models for analysis and recommendations

FAQ from mcp-jobs

What is the required Node.js version?

Node.js version >= 14.0.0 is required.

How do I get an API key?

You need to obtain an API key, which can be requested through the official website.

What are the available environment variables?

Available environment variables include MCP_JOBS_API_KEY, MCP_PROVIDER_LIEPIN_ENABLED, MCP_PROVIDER_BOSS_ENABLED, MCP_PROVIDER_ZHILIAN_ENABLED, MCP_PROVIDER_JOB51_ENABLED, MCP_PROVIDER_TIMEOUT, MCP_PROVIDER_INTERVAL, MCP_GLOBAL_MAX_RETRIES, MCP_GLOBAL_CACHE_TIME, MCP_PORT, and MCP_HOST.

How do I configure mcp-jobs in Cursor?

Configuration instructions are provided for both Cursor v0.45.6+ and v0.48.6+ versions, involving adding a new MCP server with the appropriate command and environment variables.

What should I do if I encounter issues on Windows?

If you encounter issues on Windows, try using the command: cmd /c "set MCP_JOBS_API_KEY=your-api-key && npx -y mcp-jobs"