Google Jobs

🚀 Google Jobs MCP Server

The Google Jobs MCP Server is a tool based on the Model Context Protocol (MCP), designed to provide powerful job search capabilities. It supports multiple languages and geographical locations, and can filter out eligible job information according to user needs.

🚀 Quick Start

Install Dependencies

Run the following command to install the project dependencies:

npm install

Environment Configuration

Modify your claude_desktop_config.json file and add the following content (adjust according to the actual system path):

{
  "google-jobs": {
    "command": "D:\\Program\\nvm\\node.exe",
    "args": ["D:\\github_repository\\path_to\\dist\\index.js"],
    "env": {
      "SERP_API_KEY": "your-api-key"
    }
  }
}

Build the Server

Run the following command to build the server:

npm run build

Start the Server

Run the following command to start the server:

npm start

✨ Features

• Multilingual Support: Supports job searches in multiple languages.
• Geographical Location Filtering: Allows job filtering based on specified geographical locations.
• Time Range Limitation: Enables setting a time window for job posting dates.
• Job Type Filtering: Supports filtering for various job types such as full - time and part - time.
• Salary Range Filtering: Allows users to search for jobs within a specified salary range.
• Language Code Support: Different language job pages can be displayed by setting the hl parameter.

📦 Installation

Automatic Installation with Smithery

You can automatically install the Google Jobs service on Claude Desktop using Smithery:

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

Manual Installation

Install with npm

npm i @chanmeng666/google-jobs-server

or

npm install @chanmeng666/google-jobs-server

Install with yarn

yarn add @chanmeng666/google-jobs-server

Install with pnpm

pnpm add @chanmeng666/google-jobs-server

🔧 Technical Details

• TypeScript: Developed using TypeScript.
• Node.js: Runs on the Node.js platform.
• MCP SDK: Integrates the MCP protocol for interaction.

📚 Documentation

API Documentation

This server implements the Model Context Protocol and provides a job search tool, supporting the following parameters:

Development Guide

# Run in development mode
npm run dev

# Run type checking
npm run typecheck

# Build the production version
npm run build

📄 License

This project is licensed under the MIT License.

Author Information

This tool is developed and maintained by Chan Meng. For contact information, please refer to the project homepage or email contact details.