job-search-mcp

一个用于在签证受约束条件下找工作的 MCP 服务器。

如果你需要雇主担保（sponsorship），大多数求职工具回答的是错误的问题。它们只会告诉你某个职位存在。它们不会告诉你这个雇主能否合法雇用你，也不会告诉你"mid-level"（中级）这个头衔背后是否藏着一份高级职位的要求，更不会告诉你发布职位的公司其实只是一家完全没有担保执照的招聘中介。

这个服务器负责回答这些问题。它通过 Model Context Protocol 暴露四个工具，让 AI 助手可以自己核查结果，而不是靠猜。

工具

Related MCP server: recruiting-jobs-mcp

为什么需要置信分级

检查担保执照最显而易见的做法是在登记表中搜索公司名称。这个项目就是这样起步的，但这种方法出错频率高到足以产生风险。

公司名会互相冲撞。要把 Pimberly 匹配到它的注册名称 Pimberly Software Development Limited，你必须剥离 "Software"、"Limited" 这类词。但同样的规范化处理又会让 Minerva Defence 变成 minerva，从而匹配到十三个不相关的公司：一家家具企业、一家信贷机构、一家支持性居住服务商。

所以 check_sponsor 返回的是一个置信等级，而不是布尔值：

• high —— 名称中具有区别性的部分精确匹配了一次。

• verify —— 有东西匹配上了，但也有可能只是巧合。先确认雇主注册的法人实体，再查询 那个 名称。

• none —— 没有命中。这不能证明他们不能提供担保。 很多持执照雇主经营时使用的名称与其注册名完全不同。

真正塑造了这一设计思路的真实案例：

为什么 screen_posting 要看正文，而不是只看标题

一条标题为 "Software Engineer" 的招聘信息，开头却是 "As a Senior Software Engineer you will"，并邀请应聘者加入 "创始团队"。另一条标题为 "Software Engineer (Java Mid)" 的招聘信息，在第三段之后才表明职位实际上是高级级别。仅按标题过滤都会漏掉这两条。

screen_posting 还会拦截所有无法通过任何包装绕过的硬性门槛：

You must be a UK citizen and have lived in the UK for the past 10 years.
You must already hold high-level UK security clearance.

以及在你需要担保时最要紧的那一条——来自一家持有 A 级执照的公司：

We are unable to offer visa sponsorship for this role. Candidates who need visa
sponsorship now or will need it in the future will not be considered.

持有执照意味着公司 能够 提供担保，但并不代表 愿意 担保。

为什么 search_roles 返回的是一个漏斗

英国招聘平台被招聘中介占据，而且中介并不会为它发布的职位持有担保人执照。把这些中介过滤掉既必要又简单得近乎残忍：一个典型的搜索会把七条结果压缩到一条。

只有一条结果却没有解释，看起来像 bug。所以工具会返回每个阶段到底过滤掉了什么：

{
  "totalFromSource": 7,
  "funnel": { "fromSource": 7, "afterAgencyFilter": 2, "afterSalaryAndAge": 1 },
  "notes": ["5 of 7 results were recruitment agencies or job boards. ..."]
}

未公布薪水的职位仍然会被保留，绝不会被过滤掉。因为薪资相关信息的沉默并不是薪酬低的证据。

安装

npm install && npm run build

下载当前的登记表（约 11 MB，会定期更新）：

https://www.gov.uk/government/publications/register-of-licensed-sponsors-workers

把它保存为 data/register.csv，或者将 SPONSOR_REGISTER_PATH 指向它。

Claude Desktop / Claude Code

配置说明：

{
  "mcpServers": {
    "job-search": {
      "command": "node",
      "args": ["/absolute/path/to/job-search-mcp/dist/index.js"],
      "env": {
        "SPONSOR_REGISTER_PATH": "/absolute/path/to/data/register.csv",
        "REED_API_KEY_FILE": "/absolute/path/to/.reed-api-key"
      }
    }
  }
}

任何凭据都不会从仓库内的某个文件读取，而登记表会被 .gitignore 忽略。

你还可以通过 Claude Code CLI 来配置：

claude mcp add job-search --scope user \
  --env SPONSOR_REGISTER_PATH=/path/to/data/register.csv \
  --env REED_API_KEY_FILE=/path/to/.reed-api-key \
  -- node /path/to/job-search-mcp/dist/index.js

测试

运行测试：

npm test

一共 54 个测试。每个 fixture 都是一条真实的岗位信息或一条真实的登记表记录，而这些记录曾让早期版本的逻辑失效。Reed 相关的测试用 mock 的 fetch，所以整个测试套件可以离线运行，不会产生 API 配额消耗。

有两类 bug 是这套测试在编写过程中发现并拦住的：

• £40,000-85,000 被解析为一整个固定的 40,000，因为第二个数值没有带货币符号。这在对照薪资门槛时，就是“达标”和“不达标”的差别。

• 一个写成 \brecruit\b 的中介过滤器从未命中过 Recruitment 或 Consultcy。大致上有五十万个中介直接从它中间穿过去了。

设计说明

core() 会主动丢弃一些信息。 剥离描述性词让品牌名到法人名称的匹配得以生效，而这正是导致误匹配的源头。置信分级并不是隐藏这种取舍，而是为这种取舍明确标出价格。

查无结果不等于否定。 none 会附带这样的说明。在这个领域里代价最高的错误，是以为“登记表里没有的公司一定不能提供担保”。

只读。 服务器读取申请台账，但绝不写入。是否要记录一条结果，是应该由人来做出的决定。

许可证

MIT