A Model Context Protocol (MCP) server implementation that provides Google Jobs search capabilities via SerpAPI integration. Features multi-language support, flexible search parameters, and smart error handling.

https://github.com/user-attachments/assets/8f6739e1-7db7-4171-88b4-59c6290a4c72

✨ Features

🌍 Multi-Language Support

Full localization support for English, Chinese, Japanese and Korean with automatic language detection and fallback.

🔍 Flexible Search Options

Comprehensive search parameters including:

Job title and keywords
Location with radius filtering
Employment type (full-time, part-time, etc.)
Salary range filters
Post date filtering
Results sorting

💡 Smart Error Handling

Comprehensive input validation
Helpful error messages and suggestions
Automatic search refinement suggestions
Rate limit handling

📊 Rich Job Details

Detailed job information formatting
Company benefits and highlights
Salary information when available
Direct application links
Job posting timestamps

🔄 Advanced Features

Pagination support
Multiple sorting options
Geographic radius search
Employment type filtering

🔑 SERP API Setup Guide

Before getting started, you'll need to obtain a SERP API key:

Visit SERP API website and create an account
After registration, go to your Dashboard:
- Locate the "API Key" section
- Copy your API key
- New users get 100 free API calls
API Usage Details:
- Free tier: 100 searches per month
- Paid plans start at $50/month for 5000 searches
- Billing based on successful API calls
- Multiple payment methods: Credit Card, PayPal, etc.
Usage Limits:
- Request Rate: 2 requests/second
- IP Restrictions: None
- Concurrent Requests: 5
- Response Cache Time: 1 hour

👩‍🔧 Solution for MCP Servers Connection Issues with NVM/NPM

Click to view my configuration solution 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 Quick Start

Install dependencies:

npm install

Configure environment: Modify your claude_desktop_config.json with the following content (adjust paths according to your system):

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

npm run build

Start the server:

npm start

Troubleshooting

API Key Issues:

Verify key in configuration
Check key status in SERP API dashboard
Confirm key has remaining quota

Search Issues:

Validate search parameters format
Check network connectivity
Verify country/language code support

📦 Installation

Installing via Smithery

To install Google Jobs for Claude Desktop automatically via Smithery:

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

Manual Installation

@chanmeng666/google-jobs-server

# Using npm
npm i @chanmeng666/google-jobs-server
# or
npm install @chanmeng666/google-jobs-server

# Using yarn
yarn add @chanmeng666/google-jobs-server

# Using pnpm
pnpm add @chanmeng666/google-jobs-server

💻 Tech Stack

📖 API Documentation

The server implements the Model Context Protocol and exposes a job search tool with the following parameters:

query: Search query string (required)
location: Job location (optional)
posted_age: Post date filter (optional)
employment_type: Job type filter (optional)
salary: Salary range filter (optional)
radius: Geographic search radius (optional)
hl: Language code (optional)
page: Pagination number (optional)
sort_by: Sort order (optional)

🔧 Development

# Run in development mode
npm run dev

# Run type checking
npm run typecheck

# Build for production
npm run build

📝 License

This project is MIT licensed.

🙋‍♀ Author

Created and maintained by Chan Meng.

Google Jobs MCP Server

Integrations