使用说明

项目简介

mcp-jobs 是一个基于 Model Context Protocol (MCP) 实现的职位聚合服务器，旨在为大语言模型 (LLM) 提供结构化的职位信息。它通过抓取主流招聘网站（如猎聘、BOSS直聘、智联招聘、前程无忧）的职位数据，并以标准化的格式提供给 LLM 客户端，帮助 LLM 更好地理解和处理职位相关的信息，从而支持更智能的职位搜索、推荐和分析等应用。

主要功能点

多平台职位聚合：支持从猎聘、BOSS直聘、智联招聘、前程无忧等多个主流招聘网站抓取职位信息。
结构化职位数据：将不同平台抓取的职位信息统一转换为结构化数据，方便 LLM 理解和使用。
关键词搜索：支持通过关键词搜索职位，例如职位名称、技能要求等。
职位详情获取：支持根据职位链接获取更详细的职位描述和公司信息。
MCP 标准协议：遵循 MCP 协议标准，易于集成到各种支持 MCP 协议的 LLM 客户端。

安装步骤

1. 环境准备

确保已安装 Node.js (>=14.0.0) 和 npm。

2. 安装 mcp-jobs

您可以通过 npm 进行全局安装，或者在项目内安装：

全局安装 (推荐):

npm install -g mcp-jobs

项目内安装:

npm install mcp-jobs
# 或使用 yarn
# yarn add mcp-jobs
# 或使用 pnpm
# pnpm add mcp-jobs

3. 配置 API 密钥 (可选)

部分招聘平台可能需要 API 密钥才能访问完整信息。请根据需要配置 'MCP_JOBS_API_KEY' 环境变量。具体申请方式请参考相关招聘平台官方文档。

4. 启动 MCP 服务器

全局安装方式启动：

在终端中运行以下命令启动 mcp-jobs 服务器：

export MCP_JOBS_API_KEY=YOUR-API-KEY  # 可选：设置 API 密钥，如不需要可忽略此行
mcp-jobs

项目内安装方式启动：

如果选择项目内安装，则需要在您的项目 'node_modules' 目录中找到 'mcp-jobs' 包，然后执行其入口文件 'mcp.js' (或 'mcp.ts' 编译后的 'mcp.js')。

5. 环境变量配置 (可选)

您可以通过环境变量配置 mcp-jobs 的行为，例如：

'MCP_JOBS_API_KEY': 招聘平台 API 密钥 (可选)
'MCP_PROVIDER_LIEPIN_ENABLED', 'MCP_PROVIDER_BOSS_ENABLED', 'MCP_PROVIDER_ZHILIAN_ENABLED', 'MCP_PROVIDER_JOB51_ENABLED': 控制是否启用特定招聘平台的数据抓取，默认为启用所有平台 ('true')。可以设置为 'false' 禁用。
'MCP_PROVIDER_TIMEOUT': 数据抓取超时时间，单位毫秒，默认 10000 毫秒。
'MCP_PROVIDER_INTERVAL': 数据抓取间隔时间，单位毫秒，默认 1000 毫秒。
'MCP_GLOBAL_MAX_RETRIES': 全局最大重试次数，默认 3 次。
'MCP_GLOBAL_CACHE_TIME': 全局缓存时间，单位秒，默认 3600 秒 (1 小时)。
'MCP_PORT': 服务器端口号，默认 8080 (当前版本未使用端口，为标准 MCP Stdio 服务，通过标准输入输出通信)。
'MCP_HOST': 服务器主机名，默认 localhost (当前版本未使用主机名)。

服务器配置

以下是在支持 MCP 协议的客户端 (如 Cursor, Claude Desktop, Windsurf, Cline) 中配置 mcp-jobs 服务器的 JSON 示例。您需要将此配置添加到您的 MCP 客户端设置中。

JSON 配置示例 (以 Cursor v0.48.6+ 为例):

{
  "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"
      }
    }
  }
}

配置说明:

'"mcp-jobs"': 服务器名称，您可以自定义。
'"command": "npx"': 启动命令，使用 'npx' 运行。
'"args": ["-y", "mcp-jobs"]': 命令参数，'-y' 自动确认安装，'mcp-jobs' 是要执行的包名。
'"env"': 环境变量配置。
- '"MCP_JOBS_API_KEY": "YOUR-API-KEY"': [可选] 招聘平台 API 密钥，请替换为您的实际密钥，如果不需要 API 密钥可以留空。
- '"MCP_PROVIDER_LIEPIN_ENABLED": "true"': [可选] 启用猎聘平台数据抓取。
- '"MCP_PROVIDER_BOSS_ENABLED": "true"': [可选] 启用 BOSS直聘平台数据抓取。
- '"MCP_PROVIDER_ZHILIAN_ENABLED": "true"': [可选] 启用智联招聘平台数据抓取。
- '"MCP_PROVIDER_JOB51_ENABLED": "true"': [可选] 启用前程无忧平台数据抓取。

注意: 请根据您的实际情况配置环境变量，例如是否需要 API 密钥，以及需要启用的招聘平台。

基本使用方法

在支持 MCP 协议的 LLM 客户端中配置并启动 'mcp-jobs' 服务器后，您可以通过自然语言指令，指示 LLM 使用 'mcp_search_job' 工具搜索职位信息。

例如，在聊天对话中，您可以这样提问：

"请帮我搜索北京地区的前端开发职位"
"查找上海的 Java 工程师工作，薪资要求 20k 以上"
"我想了解深圳的数据分析师岗位，最好是 3 年以上经验的"

LLM 客户端会自动识别并调用 'mcp-jobs' 服务器提供的 'mcp_search_job' 工具，并将搜索结果返回给您。

您还可以使用 'mcp_job_detail' 工具获取职位详情，例如：

"请分析一下这个职位：[职位详情页URL]"

请将 '[职位详情页URL]' 替换为实际的职位详情页面链接。

工具列表:

'mcp_search_job': 搜索职位信息
'mcp_job_detail': 获取职位详情信息

工具使用示例:

mcp_search_job 工具参数:

{
  "tool_calls": [
    {
      "id": "search_job_tool",
      "type": "function",
      "function": {
        "name": "mcp_search_job",
        "arguments": {
          "keyword": "前端开发",
          "city": "北京"
        }
      }
    }
  ]
}

mcp_job_detail 工具参数:

{
  "tool_calls": [
    {
      "id": "job_detail_tool",
      "type": "function",
      "function": {
        "name": "mcp_job_detail",
        "arguments": {
          "url": "https://m.zhipin.com/job_detail/xxxx.html"  // 替换为实际职位详情页 URL
        }
      }
    }
  ]
}

请注意，具体的使用方式可能因 LLM 客户端而异，请参考您使用的 LLM 客户端的 MCP 服务器使用文档。

关键词