Job Search MCP

job-search-mcp

一款面向 Claude Desktop 的个人求职助手。你让 Claude 查找职位；它会搜索真实的招聘网站，为每个职位打出 0–100 的匹配度评分，并将结果显示在一个可一键筛选的排名看板上。所有内容都在本地运行——无需 API 密钥，也无需账户。

它是一个 MCP App：一个 Claude Desktop 可与之通信的小型服务，外加一个直接显示在聊天中的看板。

适用范围：它专为美国软件工程职位调校（内置来源和职位筛选条件针对美国科技雇主）。搜索其他领域或地区时，结果会比较少。

**适用环境：**为 Claude Desktop 构建并经过测试。它也应该适用于同时支持运行本地（stdio）服务并渲染 MCP App 界面的其他 MCP 客户端，例如 VS Code（Copilot）、Cursor 或 Goose（未经测试）。 仅支持远程连接的客户端（ChatGPT、网页版／移动版 Claude）无法启动本地服务，因此无法使用。

功能

• 搜索真实的招聘网站——LinkedIn，以及 8 个 ATS／招聘来源（Greenhouse、Lever、Ashby、Workday、 SmartRecruiters、Hacker News、RemoteOK、Remotive），并根据你的目标职位和地点进行搜索。
• 为你评估每个职位——Claude 会阅读完整职位描述，并根据你的技能、工作年限、资历匹配度和职位类型，给出 0–100 的匹配度评分及一句话理由。
• 快速筛选——对每张卡片选择 Apply / Skip，也可以批量处理（“隐藏所有低于 60 分的职位”）。
• 记住相关信息——持续维护候选列表和已申请职位跟踪表，并且不会重复显示同一个职位（6 个月内）。

设置

1. 告诉 Claude Desktop 如何使用它。 打开配置文件：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

在 "mcpServers" 下添加以下内容——npx 会为你获取已发布的软件包，无需克隆或构建：

{
  "mcpServers": {
    "job-search": {
      "command": "npx",
      "args": ["-y", "@servation/job-search-mcp"]
    }
  }
}

2. 完全退出并重新打开 Claude Desktop（在 Windows 上，请从系统托盘退出——只关闭窗口还不够）。就这样。

npm install
npm run build

{
  "mcpServers": {
    "job-search": {
      "command": "node",
      "args": ["D:\\job-search-mcp\\dist\\main.js"]
    }
  }
}

使用方法

直接与 Claude 对话即可。例如：

• “保存我的个人资料”——先粘贴你的简历；Claude 会提取你的技能、职位、工作年限和地点，以便针对你定制搜索和评分。
• “查找加利福尼亚州的高级后端工程师职位，本周发布的。”
• “查找申请人数少的职位”——添加 LinkedIn 的早期申请者筛选条件。
• “隐藏所有低于 60 分的职位。”
• “显示我申请过的职位。”
• “重新评估看板上的职位。”

典型的首次使用流程：保存个人资料 → “查找职位” → Claude 评分并显示排名看板 → 你选择 Apply/Skip。

看板

看板是一个持续更新的候选列表。职位会一直保留在列表中，直到你选择 Apply（移至跟踪表）或 Skip（永久隐藏）。新搜索会自动跳过已在看板或跟踪表中的职位、已隐藏的职位，以及过去 6 个月内显示过的职位——这样你就不会连续看到同一条招聘信息。

点击卡片上的 Applied 或 Skip，也可以让 Claude 代为操作。在小组件中完成筛选后，结果会保留。

工具（供参考）

你很少会按名称调用这些工具——Claude 会挑选合适的工具——不过以下是它们的具体功能：

数据存储位置

你的机器上只有一个 JSON 文件——不使用云端，除你搜索的招聘网站外，不会向任何地方发送数据：

• 已安装：~/.job-search-mcp/jobs.json
• 从源代码运行：./data/jobs.json
• 使用 JOB_SEARCH_MCP_DATA 环境变量覆盖。

可选：LinkedIn Premium 模式

默认情况下，LinkedIn 使用其公开访客端点：无需登录，也没有账号登录风险，而且你已经可以获取完整的职位描述。请注意，即使在访客模式下，自动访问仍会通过你自己的 IP 发起，且违反 LinkedIn 的用户协议，请自行斟酌使用。如果你想获取更丰富的 Premium 数据，可以在服务配置中添加 env 块，使用已登录的账号：

"job-search": {
  "command": "npx",
  "args": ["-y", "@servation/job-search-mcp"],
  "env": {
    "LINKEDIN_LI_AT": "<your li_at cookie>",
    "LINKEDIN_JSESSIONID": "ajax:1234567890123456789"
  }
}

在已登录的 linkedin.com 标签页中，前往 DevTools → Application → Cookies 获取这两个 Cookie。

⚠️ 注意： 这违反 LinkedIn 的服务条款，可能导致你的账号被标记或限制。这些 Cookie 大约每月会过期一次，而且 LinkedIn 的内部端点可能随时变更，恕不另行通知。如果出现故障，系统会自动回退到访客模式。不添加 env 块即可确保安全（仅使用访客模式）。

评分机制

Claude（宿主模型）会直接进行评分——它会阅读每份职位描述并判断匹配度，因此评分校准良好。确定性公式（scoring.ts 中的 computeMatchScore）作为备用方案保留，供使用较弱本地模型的用户使用，这类模型往往会给所有工作打过高的分数；默认情况下不会启用该公式。

开发

npm run typecheck    # type-check UI + server + harness
npm run build        # build the UI bundle (vite single-file) + compile the server (tsc)
npm run serve:stdio  # run the server from source (tsx) for local testing
npm run harness      # work on the review UI without Claude Desktop (see harness/)
npm run canary       # check every job source is still returning postings

服务仅支持 stdio（main.ts → server.ts）；UI 是一个 React 应用，会打包成单个内嵌的 HTML 文件（src/mcp-app.tsx → dist/mcp-app.html），服务会将其作为 ui:// 资源提供。

开发 UI 时，请使用 harness/。它是 Claude Desktop 的本地替代环境，可使用合成的职位存储和真实的 ui/* 桥接来渲染组件。在浏览器标签页中打开 dist/mcp-app.html 只会显示“正在连接……”，而最容易出问题的部分（打开链接、主题设置、挂载后的刷新）都由宿主介入处理，因此只有连接宿主后才能发现问题。

如果某个职位来源失效，运行 npm run canary 即可查看是哪一个。公司 slug 经常失效，因此修复通常应该放在远程 slug 注册表中——updateCompanyDirectoriesFromRegistry() 会在运行时重新读取该注册表——而不是通过发布新版本来解决。