job-search-mcp

Claude Desktop용 개인 구직 도우미입니다. Claude에게 일자리를 찾아달라고 요청하면 실제 구인 게시판을 검색하고, 각 채용 공고에 본인 적합도를 0–100점으로 매긴 뒤, 한 번의 클릭으로 분류할 수 있는 순위형 보드에 표시합니다. 모든 것이 로컬에서 실행됩니다 — API 키도, 계정도 필요 없습니다.

이것은 MCP App입니다. Claude Desktop이 통신하는 작은 서버에, 채팅 창에 바로 렌더링되는 인라인 보드가 결합된 형태입니다.

적용 범위: 미국 소프트웨어 엔지니어링 직군에 맞춰 조정되었습니다(기본 내장 소스와 직군 필터가 미국 기술 기업을 대상으로 합니다). 다른 분야나 지역에서는 결과가 거의 나오지 않습니다.

동작 환경: Claude Desktop에서 빌드 및 테스트되었습니다. 로컬(stdio) 서버를 실행하고 MCP App UI를 렌더링하는 다른 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개월간).

Related MCP server: Jobless MCP

설치

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

그런 다음 설정 파일이 이 폴더의 dist/main.js를 가리키게 하세요:

{
  "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에서 두 쿠키를 모두 가져오세요.

⚠️ 주의: 이 방법은 LinkedIn 서비스 약관에 위배되며 계정이 플래그 처리되거나 제한될 수 있습니다. 쿠키도 약 한 달마다 만료되고 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는 단일 인라인 HTML 파일(src/mcp-app.tsx → dist/mcp-app.html)로 번들된 React 앱이며, 서버가 이를 ui:// 리소스로 제공합니다.

UI 작업을 할 때는 harness/를 사용하세요. 합성 채용 데이터 저장소와 실제 ui/* 브리지를 대상으로 위젯을 렌더링하는 Claude Desktop의 로컬 대용품입니다. 브라우저 탭에서 dist/mcp-app.html을 열면 "Connecting…"만 표시되며, 깨지기 쉬운 부분(링크 열기, 테마, 마운트 후 새로고침)은 모두 호스트가 중개하므로 반대편에 호스트가 있을 때만 나타납니다.

채용 소스가 죽으면 npm run canary가 어느 소스인지 알려줍니다. 회사 slug는 자주 변하므로, 수정은 새 릴리스보다는 updateCompanyDirectoriesFromRegistry()가 런타임에 다시 읽는 원격 slug 레지스트리에서 이루어지는 경우가 많습니다.