job-search-mcp
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.jsonmacOS:
~/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가 적절한 도구를 선택합니다 — 하지만 내부 구조는 다음과 같습니다:
도구 | 기능 |
| 대상 직군/위치로 게시판을 검색합니다(선택 필터: 시니어 레벨, 고용 형태, 최신성, 원격, 연봉, 지원자 수, 소스). |
| Claude가 찾은 채용 공고에 0–100점 적합도 점수를 매깁니다(검색 후 자동 실행). |
| 순위형 보드(또는 |
| 개별 채용 공고에 Apply / Skip / 저장을 적용합니다(카드 버튼도 동일). |
| 점수나 소스 기준으로 여러 건을 한 번에 분류합니다. 예: 60점 미만 모두 닫기. |
| 현재 보드를 텍스트로 나열합니다(점수가 매겨진 모든 공고 + 아직 점수가 없는 공고). |
| 추적기 — 저장하거나 지원한 채용 공고 목록입니다. |
| 보드의 모든 채용 공고를 처음부터 다시 평가합니다. |
| 정리 기능: 점수가 없는 남은 공고나 보드 전체를 지웁니다(지원/닫기 기록은 건드리지 않음). |
| 이력서 프로필을 저장합니다(검색 + 평가에 활용). |
데이터 저장 위치
모든 것이 사용자 머신의 JSON 파일 하나에 저장됩니다 — 클라우드가 없고, 검색하는 구인 게시판 외에는 어디로도 전송되지 않습니다:
설치형:
~/.job-search-mcp/jobs.json소스에서 실행:
./data/jobs.jsonJOB_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 레지스트리에서 이루어지는 경우가 많습니다.
Available Tools
10 toolsbulk_statusBulk TriageA
Triage MANY board jobs at once by score and/or source — e.g. dismiss every scored job under 60. Applies status to all scanned (board) jobs matching the filters; the server selects them, so you do NOT need the individual job ids. below_score/above_score match SCORED jobs only (use clear_jobs for un-evaluated ones). Provide at least one filter. Returns text; call show_board afterward to display.
Inputs: status (required), notes, source, above_score, +1 more.
clear_jobsClear JobsA
Clear jobs from the review board. which='unscored' (default) removes only the not-yet-evaluated leftovers; which='all' clears the whole board. Saved/applied jobs (the tracker) and dismissed jobs are NOT affected — dismissed jobs still won't be re-sourced. Returns text; call show_board to display.
Inputs: which.
evaluate_jobsEvaluate JobsA
Score one or more sourced jobs for THIS candidate (holistic). YOU assign each job a 0-100 fit score directly, using the candidate summary (shown in find_jobs / whats_promising) and the job description. Weigh the must-have requirements, the candidate's actual skills and years of experience (a role demanding far more seniority/years than the candidate has should score LOWER), domain fit, and standout strengths. Calibrate and use the FULL range — do not bunch everything at 80+: 80-100 = strong fit and realistic; 60-79 = good with real gaps; 40-59 = partial/stretch (e.g. wrong level); below 40 = poor or wrong field. Pass { job_id, score, reason } per job. Use the EXACT bracketed ids; do not invent them. Score every job in one call. Returns text; call show_board afterward to display the ranked board.
Inputs: evaluations (required).
find_jobsFind JobsA
Source live jobs (LinkedIn + Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Hacker News, RemoteOK, Remotive), dedup them, and return them as text with full descriptions. Uses the saved profile's roles/location by default; pass query/location/filters to override. This returns UNSCORED jobs and does NOT show a card UI — immediately score all of them with evaluate_jobs (a 0-100 fit score + reason each), then show_board once, to present the single ranked board. Do not just list them back.
Inputs: limit, query, remote, sort_by, +9 more.
rescore_boardRe-score BoardA
Re-score the WHOLE board from scratch — every job, INCLUDING ones that already have a score. Use this when the user asks to 'rescore'/'re-evaluate' the board or after the scoring approach changed. Returns all board jobs with their ids + descriptions; call evaluate_jobs with a FRESH { job_id, score, reason } for EACH (do not skip already-scored ones), then call show_board. Set include_saved=true to also re-score the saved/applied tracker.
Inputs: include_saved.
review_savedReview Saved JobsA
List the tracker as text: jobs marked saved (interested) or applied, with their status, score, and notes. Use this to see what you're tracking or have applied to. To DISPLAY the tracker widget, call show_board with view='saved'.
Inputs: no named parameters.
save_profileSave Resume ProfileA
Extract the candidate's profile from their resume text (which the user pastes in chat) and save it. Pull: full name; core technical skills; suggested target roles; preferred/search location; total years of professional experience (integer); and pass the resume text as rawText. The profile is used by find_jobs (target roles + location) and by scoring (years of experience drives the experience penalty), so set yearsOfExperience accurately. Merges with any existing profile.
Inputs: name, skills, rawText, targetRoles, +4 more.
set_statusSet Job StatusA
Triage a job by id: 'saved' (interested/tracking), 'applied' (also stamps the date), 'dismissed' (skip), or 'discovered' (undo back to the board). Moves it between the scanned/saved/dismissed lists and persists. Optionally attach notes. Called by the review UI; also usable directly.
Inputs: job_id (required), status (required), notes. Returns: jobs, view, count, scored, +1 more
show_boardShow BoardA
Display the job board (or the saved/applied tracker) as an interactive widget. Call this ONCE, at the end of a request, after doing the work (find_jobs/evaluate_jobs/bulk_status/clear_jobs/whats_promising are text-only and do NOT render). view='board' (default) shows the ranked board; view='saved' shows the tracker.
Inputs: view. Returns: jobs, view, count, scored, +1 more
whats_promisingWhat's PromisingA
List the current job board as text: every scored job (with its id) and any UNSCORED jobs with their ids + descriptions so you can evaluate them. To score the unscored ones, call evaluate_jobs with the EXACT bracketed ids shown. Use this to review jobs already found (find_jobs only returns brand-new ones). To re-score jobs that ALREADY have a score, use rescore_board instead. To DISPLAY the board widget to the user, call show_board (this returns text for you to act on).
Inputs: limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose: bulk_status for bulk triage, clear_jobs for clearing, evaluate_jobs for scoring single jobs, find_jobs for sourcing, rescore_board for re-evaluating all, review_saved for tracker text, save_profile for profile, set_status for individual triage, show_board for display, and whats_promising for listing. No overlap.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., bulk_status, evaluate_jobs, save_profile). The only minor deviation is 'whats_promising' using a contraction, but it still follows the pattern and is easily readable.
10 tools is well within the ideal 3-15 range for a focused job search server. Each tool addresses a necessary function without bloat, and the count feels natural for the domain.
The tool set covers the core workflow: sourcing (find_jobs), scoring (evaluate_jobs, rescore_board), triaging (bulk_status, set_status, clear_jobs), tracking (review_saved), display (show_board), and profile management (save_profile). Minor gaps like no explicit profile update tool exist, but save_profile merges, so it's almost complete.
Related MCP Connectors
AI job matching in your assistant: ranked offers, tailored resumes, application tracking.
Run your job search from your AI assistant. Career Rift gives every job its own resume, then works out the fit score, interview prep and cover letter from it, while your inbox keeps the job board current. Track applications, companies, notes, calendar events and profiles in plain language.
Tailor resumes, score ATS fit, find hiring leads, and send cold outreach, from your agent.
Job search for your AI: save jobs, research companies, keep stories, track applications.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables job search and scraping across multiple job boards (LinkedIn, Indeed, Glassdoor, etc.) with advanced filtering, directly from Claude Desktop or other MCP clients.6MIT
- AlicenseNot gradedqualityBmaintenancePersonalized job search inside Claude. Get ranked job matches based on your actual skills, not keywords.2MIT
- AlicenseAqualityDmaintenanceTransforms Claude into an AI job-hunting assistant that searches remote job boards, scores roles against your CV, generates tailored cover letters, and logs everything to a Notion tracker.11MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and evaluating job postings from LinkedIn and freehire.me directly through Claude Desktop. Provides tools to search jobs, fetch full posting details, and assess candidate fit using eligibility scans and a scoring rubric.MIT