MCP Jobs

🚀 mcp-jobs

A multi-platform job aggregation service based on the MCP (Model-Controller-Provider) architecture. It supports retrieving job information from major recruitment websites (Liepin, BOSS Zhipin, Zhilian Zhaopin, and 51job), providing structured job data for large models.

✨ Features

• Multi-platform data aggregation: Supports retrieving job information from multiple major recruitment websites.
• Unified data format: Unifies job information from different sources into a standard format for output.
• Intelligent search: Understands and parses users' query requirements through natural language processing technology.
• Efficient retrieval: Can be directly invoked in large models to quickly return job information that meets the requirements.

📦 Installation

The following are all the supported environment variables:

# API Key
MCP_JOBS_API_KEY=your-api-key

# Enabled data sources
MCP_PROVIDER_LIEPIN_ENABLED=true
MCP_PROVIDER_BOSS_ENABLED=true
MCP_PROVIDER_ZHILIAN_ENABLED=true
MCP_PROVIDER_JOB51_ENABLED=true

# Timeout and interval settings
MCP_PROVIDER_TIMEOUT=10000
MCP_PROVIDER_INTERVAL=1000

# Global settings
MCP_GLOBAL_MAX_RETRIES=3
MCP_GLOBAL_CACHE_TIME=3600

# Server settings
MCP_PORT=8080
MCP_HOST=localhost

💻 Usage Examples

Basic Usage

After configuring mcp-jobs in an AI client that supports MCP, you can describe your requirements to the large model in natural language. For example:

• "Search for front-end development engineer positions in Shanghai."
• "Find data analyst positions in Beijing, requiring more than 3 years of experience."
• "Find the product manager positions with the highest salary in Hangzhou."

The large model will automatically invoke the mcp-jobs service to obtain relevant information and display the results for you.

📚 Documentation

⚠️ Important Note

• Comply with agreements: Please strictly comply with the usage agreements and specifications of each recruitment platform.
• Control frequency: It is recommended to reasonably control the request frequency to avoid triggering the platform's blocking mechanism.
• Login requirement: Some platforms may require users to log in to obtain complete information.
• Version requirement: The Node.js version must be greater than or equal to 14.0.0.
• First use: When using it for the first time, please obtain an API key first, which can be applied for through the official website.

📄 License

MIT License

💡 Usage Tip

If you encounter any problems during use, please get help through the following methods:

• Submit a GitHub Issue.
• Send an email to: support@example.com