server-google-jobs

This MCP server implements Google's Jobs search functionality by integrating with SerpAPI. It exposes a search tool that supports multiple parameters such as query, location, posted_age, employment_type, salary, radius, language (hl), page, and sort_by, with multi-language localization and smart error handling. AI assistants can query the server using the standard MCP tool interface, calling search_jobs with the appropriate parameters to retrieve structured job results, company details, benefits, and direct application links. The server is designed to provide helpful error messages and refinement suggestions when inputs are invalid or when API quotas are nearing limits.

To use it, install the package and configure MCP client with the server, then invoke the search tool with your desired filters. For example, you can search for software engineer roles in a specific city with a salary filter and a two-page result set. The server will return detailed job entries including title, company, location, posting date, salary (if available), and application URLs, along with pagination support and sorting options.

Prerequisites:

• Node.js and npm installed on your system
• Basic familiarity with MCP client configuration

Manual installation steps:

1. Install the package from npm:

npm i @chanmeng666/google-jobs-server

2. Build the server (if you are using a build step):

npm run build

3. Run the server:

npm start

Smithery installation (optional):

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

Eval usage (optional):

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

Environment variables and configuration tips:

• SERP_API_KEY must be a valid SerpAPI key with sufficient quota. Expose it via env.SERP_API_KEY in the MCP client config or as part of your runtime environment.
• The server supports multiple languages via the hl parameter (e.g., en, zh-CN, JA, KO). Ensure your input language is compatible with the SERP API and your localization settings.
• Review SerpAPI usage limits (free tier and paid plans) and throttle requests if integrating into high-traffic scenarios.
• If you encounter connection or build issues, ensure the entry point dist/index.js exists after building, or adjust the node args to point to the correct compiled file. For evals, you can load environment variables inline with the command.
• This server exposes a search_jobs tool; consult the MCP client documentation for the exact invocation format and how to pass query, location, and other filters.