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

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. 搜索问题：

• 验证搜索参数格式

• 检查网络连接

• 验证国家/语言代码支持

📦安装

Related MCP server: MCP Server for Google Search

通过 Smithery 安装

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

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

运行评估

evals 包会加载一个 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 ：排序顺序（可选）

🔧 开发

# Run in development mode
npm run dev

# Run type checking
npm run typecheck

# Build for production
npm run build

📝 许可证

该项目已获得 MIT 许可。

🙋‍♀ 作者

由Chan Meng创建并维护。