jobhunt_mcp

一个个人 MCP 服务器，把 Claude 变成你的求职运营经理：

• 搜索：通过 JSearch API 在 LinkedIn、Indeed、ZipRecruiter、Glassdoor 上实时搜索职位，此外还支持 Adzuna

• 跟踪：在 Google Sheet 中记录每一份申请（状态、优先级、备注）

• 跟进：按期跟进，逾期未跟进的事项会自动浮出

• 人脉：按公司维护联系人，并在申请准备时直接调取

• 定制：用一个工具组织职位描述、你的主简历和联系人，让 Claude 写出有针对性的简历和求职信，并直接保存到 Google Drive

设计上它绝不会自动提交申请。自动提交机器人违反职位网站的服务条款，容易被封禁。prepare_application_package 工具则是让你一步到位完成准备，只需“审阅并点击提交”。

前置要求

• Python 3.10+

• 一个 MCP 客户端 —— 下文以 Claude Desktop 为例，但任何兼容 MCP 的客户端都可以

• 一个 Google 账户（用于 Sheets 跟踪和 Drive 简历存储）

• （可选） 免费的 RapidAPI 和/或 Adzuna 账户，用于实时职位搜索

设置

设置步骤：创建一个 Google 服务账号，与它共享一个 Sheet、Drive 文件夹和简历，再（可选）获取搜索 API 密钥，然后让 Claude Desktop 指向 server.py。Google 相关步骤大约需要 10 分钟。

1. Google 服务账号（约 5 分钟）

1. 打开 https://console.cloud.google.com → 新建一个项目（例如 jobhunt）

2. 启用 Google Sheets API 和 Google Drive API（APIs & Services → Library）

3. 在 APIs & Services → Credentials → Create credentials → Service account 下创建账号，名字随意，可选步骤跳过即可

4. 打开该服务账号 → Keys → Add key → JSON，将密钥文件保存到安全位置，例如 ~/.config/jobhunt/service-account.json

5. 复制该服务账号的电子邮件地址（以 .iam.gserviceaccount.com 结尾）——下一步会把文件共享给它

2. Google Sheet（跟踪器数据库）

1. 新建一个空白 Google Sheet，名称例如 “Job Hunt Tracker”

2. 把它以 Editor 权限共享给服务账号的邮箱

3. 从 URL 中获取电子表格 ID：docs.google.com/spreadsheets/d/<THIS_PART>/edit

服务器第一次使用时会自动创建带表头的 Jobs、Contacts 和 Activity 标签页。

3. Google Drive 文件夹 + 主简历

1. 在 Drive 中新建一个文件夹，例如 Job Applications；以 Editor 权限将其共享给服务账号，然后复制文件夹 ID

2. 把主简历作为 Google Doc 存入 Drive（这是你的完整版简历，稍后的定制会缩减它）。将其共享给服务账号，再复制它的文件 ID

4. 搜索 API 密钥（可选）

JSearch（较建议 —— 一个接口搜遍所有招聘平台）： 在 https://rapidapi.com 免费注册 → 搜索 "JSearch" → 订阅 Basic（免费）套餐 → 把 RapidAPI key 填到 RAPIDAPI_KEY 中

Adzuna： 在 https://developer.adzuna.com 免费注册 → 把 App ID 和 App Key 分别填到 ADZUNA_APP_ID、ADZUNA_APP_KEY

如果想手动粘贴职位，也可以跳过这些，用 jobhunt_add_job 即可。

5. 安装与配置

pip install -r requirements.txt

把 claude_desktop_config.example.json 复制到你的 Claude Desktop 配置（claude_desktop_config_not.json），然后填入指向 server.py 的 args 路径、GOOGLE_SERVICE_ACCOUNT_FILE 路径以及前面的 ID/key。

配置文件位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows： %APPDATA%\Claude\claude_desktop_config.json（command 使用 "python"，路径使用双反斜杠写法，例如 C:\\Users\\you\\jobhunt-mcp\\server.py）

• Linux： ~/.config/Claude/claude_desktop_config.json

重启 Claude Desktop（完全退出后再启动；Windows/macOS 上检查托盘/菜单栏图标）。服务器启动后 jobhunt 工具就会出现。

Environment variables

所有配置都在 Claude Desktop config 的 env 块中完成：

6. 验证是否可用

你可以随时用 MCP Inspector 独立测试服务器（不需要 Claude Desktop）：

npx @modelcontextprotocol/inspector python3 server.py

然后试试 jobhunt_get_master_resume（验证 Drive 访问）和 jobhunt_list_jobs（验证 Sheets 访问）。如果两条指令都以成功响应，就说明一切就绪。

工具

Tools：

示例指令

• “搜索本州 Dallas 附近本周发布的 SOC 检测工程师职位，把最匹配的三个保存下来”

• “为职位 a1b2c3d4 准备一份申请材料包，定制我的简历，并把两个文档都保存好”

• “哪些跟进事项已经过期？”

• “我刚和 Acme 结束电话面试——记录一下，并提醒我明天发一封感谢信。”

安全说明

• 服务账号的 JSON key 属于凭据，不要提交进 git 或共享文件夹

• 服务账号只能访问你明确共享给它的文件

• 从网上获取的职位描述应视为不可信内容，服务器只会把它们作为纯数据处理