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. 
