job-search-mcp

비자 제약 속에서 구직 활동을 하기 위한 MCP 서버입니다.

스폰서십이 필요하다면, 대부분의 구직 도구는 실제 질문이 아닌 다른 질문에 답을 줍니다. 그 도구는 어떤 직무가 존재한다는 사실만 알려줄 뿐입니다. 그 고용주가 당신을 법적으로 고용할 수 있는지, "중급(mid-level)"이라는 제목이 실은 시니어급 업무를 숨기고 있는지, 공고를 올린 회사가 라이선스가 전혀 없는 채용 대행사인지는 알려주지 않습니다.

이 서버는 그 질문들에 답합니다. AI 어시스턴트가 추측하는 대신 스스로 확인할 수 있도록 Model Context Protocol을 통해 네 가지 도구를 제공합니다.

Tools

Related MCP server: recruiting-jobs-mcp

신뢰도 등급이 존재하는 이유

스폰서 라이선스를 확인하는 가장 당연한 방법은 등록부에서 회사 이름을 검색하는 것입니다. 이 프로젝트도 그렇게 시작했습니다. 그러나 이 방법은 위험할 정도로 자주 틀립니다.

회사 이름은 충돌합니다. Pimberly를 법인등록명인 Pimberly Software Development Limited에 대응시키려면 "Software"나 "Limited" 같은 단어를 제거해야 합니다. 그런데 그와 동일한 정규화는 Minerva Defence를 minerva로 바꾸고, 그 결과 가구 업체, 신용정보 회사, 지원 생활 서비스 제공업체 등 서로 무관한 열세 개 회사와 매칭되어 버립니다.

그래서 check_spion는 불리언(boolean) 대신 신뢰도 등급을 반환합니다:

• high — 이름에서 구분되는 핵심 부분이 정확히 한 번 일치했습니다.

• verify — 무엇인가 일치했지만 우연일 수 있습니다. 고용주의 등록된 법인명을 확인한 후 그 이름으로 검색하세요.

• none — 일치한 것이 없습니다. 이것은 그들이 스폰서할 수 없다는 증거가 아닙니다. 많은 라이선스 보유 고용주가 등록된 명칭과는 다른 상호로 활동합니다.

이 결정을 만든 실제 사례:

screen_posting이 제목이 아니라 본문을 읽는 이유

"Software Engineer"라는 제목의 공고는 *"As a Senior Software Engineer you will"*로 시작하고, *"the founding team"*에 참여할 사람을 매달봤습니다. 또 다른 공고는 "Software Engineer (Java Mid)"라는 제목이었지만 세 문단 아래에서 시니어 등급을 요구했습니다. 제목 기반 필터링은 이 두 가지를 모두 놓칩니다.

screen_posting은 또한 아무리 지원 서류를 다듬어도 통과할 수 없는 절대 조건(hard conditions)을 잡아냅니다:

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.

라이선스를 보유했다는 것은 그 회사가 can은 스폰서할 수 있다는 뜻입니다. 그 회사가 반드시 그렇게 하겠다는 뜻은 아닙니다.

왜 search_roles는 퍼널을 반환하는가

영국 잡 보드는 채용 대행사가 지배하고 있습니다. 그리고 에이전시는 자기가 광고하는 역할의 스폰서 라이선스를 갖고 있지 않습니다. 이들을 걸러내는 것은 반드시 필요하며, 결코 있지 않는 결과를 만듭니다: 대표적인 검색은 단 7건에서 1건으로 떨어집니다.

설명 없는 단 하나의 결과는 버그처럼 보입니다. 그래서 이 도구는 각 단계에서 무엇을 제거했는지 반환합니다:

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

공개되지 않은 급여 정보는 유지되며, 걸러내지 않습니다. 급여에 대해 침묵하는 것이 낮은 급여라는 증거는 아닙니다.

Install

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개의 테스트. 모든 테스트 픽스처는 이 코드의 이전 버전을 무너뜨렸던 실제 공고 또는 실제 등록부 기록입니다. Reed 테스트는 fetch를 모킹(mock으로 대체)하므로, 테스트 스위트는 오프라인에서 실행되며 API 할당량을 소모하지 않습니다.

테스트 작성 중 발견된 두 가지 버그는 다음과 같습니다:

• £40,000-85,000가 그냥 £40,000로 파싱되었습니다. 두 번째 금액에 통화 기호가 없기 때문입니다. 급여 기준선에 비교 조건에 따라 "기준 충족"과 "기준 미충족"이 달라집니다.

• \brecru\b를 사용한 에이전트 필터가 Recruitment이나 Consultancy와 전혀 일치하지 않았습니다. 결과적으로 대략 50개 대행사가 그냥 통과했습니다.

설계 노트

core()은 의도적으로 정보를 제거합니다. 그 설명용 단어(descriptor)를 제거하는 것이 브랜드 이름과 법인명 매칭을 가능하게 하고, 정확히 그 때문에 false positive가 발생하기도 합니다. 신뢰도 등급은 이런 트레이드오프를 숨기지 않고 대가를 명확히 매겨 보여줍니다.

등재되어 있지 않다는 것은 부정적 증거가 아닙니다. none에는 그 뜻을 명시하는 주의 문구와 함께 존재하는 예매. 그리고 이 도메인에서 가장 큰 실수는 등재되지 않은 고용주가 스리게를 면할 수 없다고 단정하는 문제입니다.

Read-only (읽기 전용). 서버는 적용 이력(application ledger)을 읽기만 하며, 절대 기록하지 않습니다. 지원 결과를 저장하는 결정은 반드시 사람이 해야 할 일입니다.

Licence

MIT