谷歌工作服务器
项目介绍
技术文档摘要
这是一个通过与SerpAPI集成提供Google Jobs搜索功能的Model Context Protocol (MCP)服务器实现。支持多语言、灵活的搜索参数以及智能错误处理。
https://github.com/user-attachments/assets/8f6739e1-7db7-4171-88b4-59c6290a4c72
✨ 特性
🌍 多语言支持
全面支持英语、中文、日语和韩语，并自动检测语言并提供回退选项。
🔍 灵活的搜索选项
全面的搜索参数包括：
- 职位名称和关键词
- 地点及半径过滤
- 就业类型（全职、兼职等）
- 薪资范围过滤
- 发布日期过滤
- 结果排序
💡 智能错误处理
- 全面的输入验证
- 帮助性的错误消息和建议
- 自动搜索优化建议
- 速率限制处理
📊 丰富的职位详情
- 详细的职位信息格式化
- 公司福利和亮点
- 可用时的薪资信息
- 直接申请链接
- 职位发布时间戳
🔄 高级特性
- 分页支持
- 多种排序选项
- 地理半径搜索
- 就业类型过滤
🔑 SERP API 设置指南
在开始之前，您需要获取一个 SERP API 密钥：
-
访问 SERP API 网站 并创建一个账户
-
注册后，进入您的仪表板：
- 找到“API 密钥”部分
- 复制您的 API 密钥
- 新用户可获得 100 次免费 API 调用
-
API 使用详情：
- 免费层级：每月 100 次搜索
- 付费计划从每月 5000 次搜索起价 50 美元
- 根据成功的 API 调用进行计费
- 支持多种支付方式：信用卡、PayPal 等
-
使用限制：
- 请求速率：每秒 2 次请求
- IP 限制：无
- 并发请求：5 次
- 响应缓存时间：1 小时
👩🔧 解决 MCP 服务器连接问题与 NVM/NPM
点击查看我的配置解决方案 👉 https://github.com/modelcontextprotocol/servers/issues/76
🚀 快速开始
- 安装依赖项：
npm install
- 配置环境：
修改您的
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"
}
}
}
- 构建服务器：
npm run build
- 启动服务器：
npm start
故障排除
- API 密钥问题：
- 验证配置中的密钥
- 在 SERP API 仪表板中检查密钥状态
- 确认密钥仍有剩余配额
- 搜索问题：
- 验证搜索参数格式
- 检查网络连接
- 验证国家/语言代码支持
📦 安装
通过 Smithery 安装
要通过 Smithery 自动安装 Google Jobs for Claude Desktop：
npx -y @smithery/cli install @chanmeng666/google-jobs-server --client claude
手动安装
<img src="https://cdn.simpleicons.org/npm/CB3837" height="14"/> <a href="https://www.npmjs.com/package/@chanmeng666/google-jobs-server">@chanmeng666/google-jobs-server</a>
# 使用 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 文档
该服务器实现了 Model Context Protocol，并提供了具有以下参数的职位搜索工具：
query: 搜索查询字符串（必需）location: 职位地点（可选）posted_age: 发布日期过滤器（可选）employment_type: 职位类型过滤器（可选）salary: 薪资范围过滤器（可选）radius: 地理搜索半径（可选）hl: 语言代码（可选）page: 分页编号（可选）sort_by: 排序顺序（可选）
🔧 开发
# 在开发模式下运行
npm run dev
# 运行类型检查
npm run typecheck
# 为生产构建
npm run build
📝 许可证
本项目采用 MIT 许可证。
🙋♀ 作者
由 Chan Meng 创建并维护。
AI 助手使用指南
此 MCP 服务器经过优化，适用于 AI 助手集成。AI 助手可以通过以下方法使用此工具：
AI 快速入门
- 安装：
npm install @chanmeng666/google-jobs-server - 配置：将服务器配置添加到 MCP 客户端
- 使用：调用
search_jobs工具进行职位搜索
AI 搜索参数
query: 搜索关键词（必需）location: 职位地点posted_age: 发布日期过滤器（今天、3天、一周、一个月）employment_type: 职位类型（全职、兼职、合同工、实习生）salary: 薪资范围（例如，$50K+，$100K+）radius: 搜索半径（例如，10英里，20英里，50英里）hl: 语言代码（en，zh-CN，ja，ko）page: 页码（每页 10 条结果）sort_by: 排序顺序（日期、相关性、薪资）
AI 使用案例
- 帮助用户查找特定职位
- 提供多语言职位搜索能力
- 根据标准筛选工作机会
- 获取详细的工作信息和申请链接
AI 错误处理
系统提供智能错误提示和搜索建议，以帮助优化搜索参数。