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:

1. Visit SERP API website and create an account

2. After registration, go to your Dashboard:

3. Locate the "API Key" section
4. Copy your API key

5. New users get 100 free API calls

6. API Usage Details:

7. Free tier: 100 searches per month
8. Paid plans start at $50/month for 5000 searches
9. Billing based on successful API calls

10. Multiple payment methods: Credit Card, PayPal, etc.

11. Usage Limits:

12. Request Rate: 2 requests/second
13. IP Restrictions: None
14. Concurrent Requests: 5
15. 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

1. Install dependencies:

   npm install

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

   {
     "google-jobs": {
       "command": "D:Programnvmnode.exe",
       "args": ["D:github_repositorypath_todistindex.js"],
       "env": {
         "SERP_API_KEY": "your-api-key"
       }
     }
   }

3. Build the server:

   npm run build

4. Start the server:

   npm start

Troubleshooting

1. API Key Issues:
2. Verify key in configuration
3. Check key status in SERP API dashboard

4. Confirm key has remaining quota

5. Search Issues:

6. Validate search parameters format
7. Check network connectivity
8. 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.