使用说明

项目简介

'Google Jobs MCP Server' 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型 (LLM) 客户端提供强大的 Google Jobs 职位搜索功能。它通过集成 SerpAPI 服务，允许用户通过自然语言查询来搜索 Google Jobs 中的职位信息。此服务器支持多语言搜索，并提供丰富的搜索参数，以满足各种求职需求。

主要功能点

职位搜索: 通过关键词、地点等信息在 Google Jobs 上搜索职位。
多语言支持: 支持英语、中文、日语和韩语，并能自动检测或手动设置语言。
灵活的搜索参数: 支持职位关键词、地点、发布时间、工作类型、薪资范围、搜索半径等多种过滤条件。
详细职位信息: 返回职位标题、公司、地点、发布时间、工作类型、薪资、职位亮点、公司福利、职位描述和申请链接等详细信息。
分页和排序: 支持结果分页和按日期、相关性或薪资排序。
智能错误处理: 提供输入验证、友好的错误提示和搜索建议。

安装步骤

方法一：通过 Smithery 安装 (推荐 Claude Desktop 用户使用)

确保已安装 Smithery CLI。

运行以下命令，自动安装 'Google Jobs' 服务器到 Claude Desktop：

npx -y @smithery/cli install @chanmeng666/google-jobs-server --client claude

方法二：手动安装

安装 npm 包: 使用 npm, yarn 或 pnpm 安装 '@chanmeng666/google-jobs-server' 包。

npm install @chanmeng666/google-jobs-server

或者

yarn add @chanmeng666/google-jobs-server

或者

pnpm add @chanmeng666/google-jobs-server

配置 SerpAPI 密钥:

访问 SERP API 官网注册并获取 API 密钥。

设置环境变量 'SERP_API_KEY' 为您的 SerpAPI 密钥。例如，在 Linux/macOS 中：

export SERP_API_KEY=your-api-key

或者在 Windows 命令行中：

set SERP_API_KEY=your-api-key

或者在 Windows PowerShell 中：

$env:SERP_API_KEY="your-api-key"

服务器配置

MCP 客户端 (如 Claude Desktop) 需要配置服务器的启动信息才能连接并使用 'Google Jobs MCP Server'。以下是 'claude_desktop_config.json' 的配置示例，请根据您的实际安装路径进行调整：

{
  "google-jobs": {  // 服务器名称，在客户端中用于标识
    "command": "/path/to/node",  // Node.js 运行时命令的绝对路径，例如：/usr/bin/node 或 C:\\Program Files\\nodejs\\node.exe
    "args": ["/path/to/node_modules/@chanmeng666/google-jobs-server/dist/index.js"], // 服务器入口文件 index.js 的绝对路径，通常位于项目安装目录的 node_modules 下
    "env": {
      "SERP_API_KEY": "your-api-key" //  SerpAPI 密钥，请替换为您的实际密钥
    }
  }
}

配置说明:

'command': 指向 Node.js 运行时的可执行文件路径。请根据您的 Node.js 安装位置填写。
'args': 包含服务器入口文件 'index.js' 路径的字符串数组。请根据 '@chanmeng666/google-jobs-server' 包的实际安装路径填写。
'env': 一个包含环境变量的 JSON 对象。'SERP_API_KEY' 必须设置为您从 SerpAPI 获取的 API 密钥。

注意: 请将 '/path/to/node' 和 '/path/to/node_modules/@chanmeng666/google-jobs-server/dist/index.js' 替换为您的实际路径。您可以使用 'which node' (Linux/macOS) 或 'where node' (Windows) 命令查找 Node.js 的路径。'index.js' 的路径通常在您安装 '@chanmeng666/google-jobs-server' 包的 'node_modules' 目录下。

基本使用方法

启动服务器: 如果您是手动安装的，并且需要手动启动服务器，请在命令行中执行以下命令：

npm start

或者直接运行入口文件:

node /path/to/node_modules/@chanmeng666/google-jobs-server/dist/index.js

(如果您通过 Smithery 安装，服务器通常会自动启动)

在 MCP 客户端中使用: 在支持 MCP 协议的 LLM 客户端 (例如 Claude Desktop) 中，配置并连接到 'Google Jobs MCP Server'。

调用 'search_jobs' 工具: 在 LLM 客户端中，您可以指示 LLM 调用 'search_jobs' 工具来进行职位搜索。工具的基本参数包括：

'query' (必需): 搜索关键词，例如 "软件工程师", "数据分析师" 等。
'location' (可选): 工作地点，例如 "北京", "上海", "New York" 等。
其他可选参数: 例如 'posted_age', 'employment_type', 'salary', 'radius', 'hl' (语言), 'page', 'sort_by' 等，可以根据需要设置。

示例: 让 LLM 客户端调用 'search_jobs' 工具，查询 "北京" 的 "软件工程师" 职位：

{
  "tool_calls": [
    {
      "id": "search_jobs-1",
      "type": "function",
      "function": {
        "name": "search_jobs",
        "arguments": {
          "query": "软件工程师",
          "location": "北京"
        }
      }
    }
  ]
}

服务器将返回搜索结果，包含职位列表和详细信息。

通过以上步骤，您就可以成功安装、配置并使用 'Google Jobs MCP Server' 为您的 LLM 应用提供强大的职位搜索能力。

关键词