Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

mcp-jobs

MCP.Pizza Chef: mergedao

mcp-jobs is an MCP server that aggregates job listings from leading Chinese recruitment websites like Liepin, Boss Zhipin, Zhilian, and 51job. It normalizes data into a unified, structured format with flexible search filters such as job title, city, and salary range. This server provides real-time updated, standardized job data optimized for large language model consumption and analysis, enabling seamless multi-platform job information integration.

Use This MCP server To

Aggregate job listings from multiple Chinese recruitment platforms Provide structured job data for AI model processing Filter job listings by title, city, and salary range Keep job data updated in real-time for accurate results Normalize diverse job data into a unified format

README

mcp-jobs

基于 MCP(Model-Controller-Provider)架构的多平台职位聚合服务,支持从主流招聘网站(猎聘、BOSS直聘、智联招聘、前程无忧)获取职位信息,为大模型提供结构化的职位数据。

NPM Version Node.js Version License

功能特性

  • 多平台数据聚合:支持从多个主流招聘网站获取职位信息
  • 统一数据格式:将不同平台的数据统一为标准格式
  • 灵活搜索条件:支持按职位名称、城市、薪资范围等条件筛选
  • 实时数据更新:保证职位信息的时效性
  • 结构化输出:提供标准化的数据格式,方便大模型处理和分析

安装方式

通过 npx 临时运行

最简单的方式是使用 npx 临时运行,不需要全局安装:

# 使用环境变量设置 API KEY
env MCP_JOBS_API_KEY=your-api-key npx -y mcp-jobs

全局安装

如果您需要频繁使用,建议全局安装:

# 全局安装
npm install -g mcp-jobs

# 运行服务
export MCP_JOBS_API_KEY=your-api-key
mcp-jobs

项目内安装

# 安装到项目依赖中
npm install mcp-jobs
# 或使用 yarn
yarn add mcp-jobs
# 或使用 pnpm
pnpm add mcp-jobs

在各 AI 客户端中配置

Cursor 配置

Cursor v0.45.6+ 配置方法
  1. 打开 Cursor 设置
  2. 进入 Features > MCP Servers
  3. 点击 "+ Add New MCP Server"
  4. 输入以下信息:
    • Name: "mcp-jobs"(或您喜欢的名称)
    • Type: "command"
    • Command: env MCP_JOBS_API_KEY=your-api-key npx -y mcp-jobs
Cursor v0.48.6+ 配置方法
  1. 打开 Cursor 设置
  2. 进入 Features > MCP Servers
  3. 点击 "+ Add new global MCP server"
  4. 输入以下代码:
{
  "mcpServers": {
    "mcp-jobs": {
      "command": "npx",
      "args": ["-y", "mcp-jobs"],
      "env": {
        "MCP_JOBS_API_KEY": "YOUR-API-KEY",
        "MCP_PROVIDER_LIEPIN_ENABLED": "true",
        "MCP_PROVIDER_BOSS_ENABLED": "true",
        "MCP_PROVIDER_ZHILIAN_ENABLED": "true",
        "MCP_PROVIDER_JOB51_ENABLED": "true"
      }
    }
  }
}

注意:如果您使用 Windows 系统并遇到问题,请尝试: cmd /c "set MCP_JOBS_API_KEY=your-api-key && npx -y mcp-jobs"

Claude Desktop 配置

在 Claude Desktop 中使用时,您需要在应用设置中添加 MCP 服务器配置:

  1. 打开 Claude Desktop
  2. 点击左下角 Settings 图标
  3. 选择 "MCP Servers" 选项
  4. 点击 "Add New Server"
  5. 输入以下信息:
    • Name: "mcp-jobs"
    • Type: "command"
    • Command: npx -y mcp-jobs
    • Environment Variables:
      • MCP_JOBS_API_KEY: 您的 API 密钥
      • MCP_PROVIDER_LIEPIN_ENABLED: "true"
      • MCP_PROVIDER_BOSS_ENABLED: "true"

Windsurf 配置

将以下配置添加到您的 ./codeium/windsurf/model_config.json 文件中:

{
  "mcpServers": {
    "mcp-server-jobs": {
      "command": "npx",
      "args": ["-y", "mcp-jobs"],
      "env": {
        "MCP_JOBS_API_KEY": "YOUR_API_KEY",
        "MCP_PROVIDER_LIEPIN_ENABLED": "true",
        "MCP_PROVIDER_BOSS_ENABLED": "true",
        "MCP_PROVIDER_ZHILIAN_ENABLED": "true",
        "MCP_PROVIDER_JOB51_ENABLED": "true"
      }
    }
  }
}

Cline 配置

在 Cline 中使用时,您需要在项目根目录创建 .cline.yaml 文件:

mcp:
  servers:
    mcp-jobs:
      command: npx
      args: ["-y", "mcp-jobs"]
      env:
        MCP_JOBS_API_KEY: "YOUR_API_KEY"
        MCP_PROVIDER_LIEPIN_ENABLED: "true"
        MCP_PROVIDER_BOSS_ENABLED: "true"
        MCP_PROVIDER_ZHILIAN_ENABLED: "true"
        MCP_PROVIDER_JOB51_ENABLED: "true"

环境变量配置

以下是支持的所有环境变量:

# API 密钥
MCP_JOBS_API_KEY=your-api-key

# 启用的数据源
MCP_PROVIDER_LIEPIN_ENABLED=true
MCP_PROVIDER_BOSS_ENABLED=true
MCP_PROVIDER_ZHILIAN_ENABLED=true
MCP_PROVIDER_JOB51_ENABLED=true

# 超时和间隔设置
MCP_PROVIDER_TIMEOUT=10000
MCP_PROVIDER_INTERVAL=1000

# 全局设置
MCP_GLOBAL_MAX_RETRIES=3
MCP_GLOBAL_CACHE_TIME=3600

# 服务器设置
MCP_PORT=8080
MCP_HOST=localhost

在大模型中使用

当您在支持 MCP 的 AI 客户端中配置好 mcp-jobs 后,您可以通过自然语言向大模型描述您的需求,例如:

  • "搜索上海地区的前端开发工程师职位"
  • "查找北京的数据分析师岗位,要求 3 年以上经验"
  • "找出杭州地区薪资最高的产品经理职位"

大模型会自动调用 mcp-jobs 服务获取相关信息并为您展示结果。

注意事项

  1. 请遵守各招聘平台的使用协议和规范
  2. 建议控制请求频率,避免被封禁
  3. 部分平台可能需要登录才能获取完整信息
  4. Node.js 版本要求:>=14.0.0
  5. 首次使用时,需要获取 API 密钥,可通过官方网站申请

开源协议

MIT License

获取帮助

如果您在使用过程中遇到任何问题,请通过以下方式获取帮助:

mcp-jobs FAQ

How do I install mcp-jobs for temporary use?
Use npx with your API key: `env MCP_JOBS_API_KEY=your-api-key npx -y mcp-jobs` for quick, no-install usage.
Can I install mcp-jobs globally?
Yes, install globally via `npm install -g mcp-jobs`, then run with your API key environment variable set.
How does mcp-jobs unify data from different job platforms?
It normalizes job listings into a standard structured format, simplifying multi-source integration.
What search filters does mcp-jobs support?
You can filter job listings by position name, city, and salary range to refine results.
Is the job data provided by mcp-jobs updated in real-time?
Yes, it ensures timely updates to reflect the latest job postings across platforms.
How do I configure mcp-jobs in AI clients like Cursor?
Add it as an MCP server in Cursor settings under Features > MCP Servers, specifying the command and API key.
What platforms does mcp-jobs support?
It supports major Chinese job sites including Liepin, Boss Zhipin, Zhilian, and 51job.
Does mcp-jobs require an API key?
Yes, you must set the MCP_JOBS_API_KEY environment variable to authenticate usage.