一个通过集成 SerpAPI 提供 Google Jobs 搜索功能的模型上下文协议（MCP）服务器实现。支持多语言、灵活的搜索参数和智能错误处理。

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

✨ 功能

🌍 多语言支持

全面支持英语、中文、日语和韩语，具有自动语言检测和回退功能。

🔍 灵活的搜索选项

全面的搜索参数包括：

• 职位名称和关键词
• 带有半径过滤的位置
• 工作类型（全职、兼职等）
• 薪资范围过滤
• 发布日期过滤
• 结果排序

💡 智能错误处理

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

📊 丰富的职位详情

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

🔄 高级功能

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

🔑 SERP API 设置指南

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

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

2. 注册后，转到您的仪表板：

   • 找到“API 密钥”部分
   • 复制您的 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

2. 配置环境： 修改您的 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"
    }
  }
}

3. 构建服务器：

npm run build

4. 启动服务器：

npm start

故障排除

1. API 密钥问题：

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

2. 搜索问题：

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

📦 安装

通过 Smithery 安装

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

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

手动安装

@chanmeng666/google-jobs-server

# 使用 npm
npm i @chanmeng666/google-jobs-server
# 或
npm install @chanmeng666/google-jobs-server

# 使用 yarn
yarn add @chanmeng666/google-jobs-server

# 使用 pnpm
pnpm add @chanmeng666/google-jobs-server

运行评估

评估包加载一个 mcp 客户端，然后运行 index.ts 文件，因此在测试之间无需重新构建。您可以通过在 npx 命令前添加前缀来加载环境变量。完整文档可在此处找到 这里。

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

💻 技术栈

📖 API 文档

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

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

🔧 开发

# 在开发模式下运行
npm run dev

# 运行类型检查
npm run typecheck

# 构建生产版本
npm run build

📝 许可证

本项目采用 MIT 许可证。

🙋‍♀ 作者

由 Chan Meng 创建和维护。