这是一个通过集成 SerpAPI 提供 Google Jobs 搜索功能的 Model Context Protocol (MCP) 服务器实现。它支持多语言、灵活的搜索参数和智能错误处理。

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

✨ 功能

🌍 多语言支持

全面支持英语、中文、日语和韩语，自动检测语言并提供回退机制。

🔍 灵活的搜索选项

包括以下综合搜索参数：

• 职位名称和关键词
• 地点及半径过滤
• 就业类型（全职、兼职等）
• 薪资范围过滤
• 发布日期过滤
• 结果排序

💡 智能错误处理

• 全面的输入验证
• 有用的错误消息和建议
• 自动搜索优化建议
• 速率限制处理

📊 丰富的职位详情

• 详细的职位信息格式
• 公司福利和亮点
• 可用时显示薪资信息
• 直接申请链接
• 职位发布时间戳

🔄 高级功能

• 分页支持
• 多种排序选项
• 地理半径搜索
• 就业类型过滤

🔑 SERP API 设置指南

在开始之前，您需要获取一个 SERP API 密钥：

1. 访问 SERP API 网站 并创建一个账户

2. 注册后，前往您的仪表盘：

   • 找到“API Key”部分
   • 复制您的 API 密钥
   • 新用户可获得 100 次免费 API 调用

3. API 使用详情：

   • 免费层级：每月 100 次搜索
   • 付费计划从每月 $50 起，包含 5000 次搜索
   • 根据成功的 API 调用计费
   • 多种支付方式：信用卡、PayPal 等

4. 使用限制：

   • 请求速率：每秒 2 次请求
   • IP 限制：无
   • 并发请求：5
   • 响应缓存时间：1 小时

👩‍🔧 MCP 服务器连接问题与 NVM/NPM 的解决方案

点击查看我的配置解决方案 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 快速开始

1. 安装依赖项：

npm install

1. 配置环境：
   根据您的系统调整路径，修改 claude_desktop_config.json 文件内容为如下所示：

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

1. 构建服务器：

npm run build

1. 启动服务器：

npm start

故障排除

1. API 密钥问题：

• 在配置中验证密钥
• 在 SERP API 仪表板中检查密钥状态
• 确认密钥有剩余配额

1. 搜索问题：

• 验证搜索参数格式
• 检查网络连接
• 确认支持的国家/语言代码

📦 安装

通过 Smithery 安装

要通过 Smithery 自动安装 Google Jobs for Claude Desktop：

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

手动安装

@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

💻 技术栈

📖 API 文档

该服务器实现了模型上下文协议，并提供了一个具有以下参数的工作搜索工具：

• query: 搜索查询字符串（必需）
• location: 工作地点（可选）
• posted_age: 发布日期过滤器（可选）
• employment_type: 工作类型过滤器（可选）
• salary: 薪资范围过滤器（可选）
• radius: 地理搜索半径（可选）
• hl: 语言代码（可选）
• page: 分页编号（可选）
• sort_by: 排序顺序（可选）

🔧 开发

# Run in development mode
npm run dev

# Run type checking
npm run typecheck

# Build for production
npm run build

📝 许可证

本项目采用 MIT 许可。

🙋‍♀ 作者

由 Chan Meng 创建并维护。