jobhunt_mcp

Claude를 구직 운영 관리자로 바꿔주는 개인 MCP 서버:

• 검색 — LinkedIn, Indeed, ZipRecruiter, Glassdoor(JSearch API) 및 Adzuna의 실시간 채용 공고

• 추적 — 모든 지원 내역을 Google Sheet에 기록(상태, 우선순위, 메모)

• 후속 조치 — 일정 기반, 기한이 지난 알림이 자동으로 표시됨

• 네트워킹 — 회사별 연락처를 유지하고 준비 단계에서 활용

• 맞춤화 — 하나의 도구가 채용 공고 + 마스터 이력서 + 연락처를 모아 Claude가 맞춤 이력서와 자기소개서를 작성하고 Google Drive에 바로 저장

설계상 지원서를 자동 제출하지 않습니다. 자동 제출 봇은 채용 사이트 이용약관을 위반하며 플래그가 지정됩니다. prepare_application_package 도구를 사용하면 "검토 후 클릭하여 제출"까지 한 단계로 도달할 수 있습니다.

사전 요구 사항

• Python 3.10 이상

• MCP 클라이언트 — 아래에서는 Claude Desktop을 가정하지만, MCP 호환 클라이언트라면 모두 작동합니다.

• Google 계정 (Sheets 추적기 + Drive 이력서 저장용)

• (선택 사항) 실시간 채용 검색을 위한 무료 RapidAPI 및/또는 Adzuna 계정

설정

설정 절차는 다음과 같습니다: Google 서비스 계정을 만들고, Sheet + Drive 폴더 + 이력서를 공유하고, (선택 사항으로) 검색 API 키를 확보한 다음, Claude Desktop이 server.py를 가리키게 합니다. Google 단계에 약 10분이 소요됩니다.

1. Google 서비스 계정 (약 5분)

1. https://console.cloud.google.com에 접속 → 프로젝트 생성(예: jobhunt).

2. Google Sheets API 및 Google Drive API를 사용 설정합니다(API 및 서비스 → 라이브러리).

3. API 및 서비스 → 사용자 인증 정보 → 사용자 인증 정보 만들기 → 서비스 계정. 이름은 무엇이든 괜찮습니다. 선택 단계는 건너뜁니다.

4. 서비스 계정을 열고 → 키 → 새 키 만들기 → JSON. 파일을 안전한 곳에 저장합니다(예: ~/.config/jobhunt/service-account.json).

5. 서비스 계정의 이메일 주소(.iam.gserviceaccount.com으로 끝남)를 복사합니다 — 다음 단계에서 이 주소로 공유합니다.

2. Google Sheet (추적 데이터베이스)

1. "Job Hunt Tracker"와 같은 이름의 빈 Google Sheet를 만듭니다.

2. 서비스 계정 이메일과 편집자 권한으로 공유합니다.

3. URL에서 스프레드시트 ID를 가져옵니다: docs.google.com/spreadsheets/d/<이 부분>/edit.

서버는 첫 사용 시 Jobs, Contacts, Activity 탭을 헤더와 함께 자동으로 생성합니다.

3. Google Drive 폴더 + 마스터 이력서

1. "Job Applications"와 같은 Drive 폴더를 만들고 서비스 계정과 편집자 권한으로 공유합니다. URL에서 폴더 ID를 복사합니다.

2. 마스터 이력서를 Google 문서로 Drive에 올립니다(모든 경력이 담긴 버전 — 맞춤화 과정에서 축소됩니다). 서비스 계정과 공유합니다. 파일 ID를 복사합니다.

4. 검색 API 키 (선택 사항)

JSearch (권장 — 모든 채용 사이트를 한 번에 검색): https://rapidapi.com에서 무료 → "JSearch" 검색 → Basic(무료) 플랜 구독 → RapidAPI 키를 RAPIDAPI_KEY에 복사합니다.

Adzuna: https://developer.adzuna.com에서 무료 → 가입 → App ID와 App Key를 ADZUNA_APP_ID 및 ADZUNA_APP_KEY에 복사합니다.

jobhunt_add_job으로 채용 공고를 직접 붙여넣는 방식을 선호한다면 이 단계를 건너뛰어도 됩니다.

5. 설치 및 구성

pip install -r requirements.txt

claude_desktop_config.example.json을 Claude Desktop 설정(claude_desktop_config.json)에 복사한 다음, args의 server.py 경로, GOOGLE_SERVICE_ACCOUNT_FILE 경로, 그리고 위 단계에서 얻은 ID/키를 입력합니다.

설정 파일 위치:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json (command에는 "python"을 사용하고 경로는 이중 백슬래시 사용, 예: C:\\Users\\you\\jobhunt-mcp\\server.py)

• Linux: ~/.config/Claude/claude_desktop_config.json

Claude Desktop을 다시 시작합니다(완전히 종료 — Windows/macOS에서는 트레이/메뉴 바 확인). 서버가 시작되면 jobhunt 도구가 나타납니다.

환경 변수

모든 것은 Claude Desktop 설정의 env 블록을 통해 구성됩니다:

6. 작동 확인

언제든지 MCP Inspector로 서버를 단독 테스트할 수 있습니다(Claude Desktop 불필요):

npx @modelcontextprotocol/inspector python3 server.py

그런 다음 jobhunt_get_master_resume(Drive 접근 확인)과 jobhunt_list_jobs(Sheets 접근 확인)를 시도해 보세요. 둘 다 인증 오류 없이 반환되면 설정이 완료된 것입니다.

도구

사용해 볼 예시 프롬프트

• "달라스 지역 SOC 탐지 엔지니어 채용 공고를 이번 주 게시분으로 모든 채용 사이트에서 검색하고, 가장 적합한 3개를 저장해 줘."

• "job a1b2c3d4에 대한 지원 패키지를 준비하고, 내 이력서를 그에 맞게 조정한 다음 두 문서를 저장해 줘."

• "내가 밀린 후속 조치는 뭐야?"

• "방금 Acme와 전화 면접을 끝냈어. 기록해 두고 내일 감사 이메일을 보내라고 알려줘."

보안 참고 사항

• 서비스 계정 JSON 키는 자격 증명입니다 — git 및 공유 폴더에 보관하지 마세요.

• 서비스 계정은 명시적으로 공유한 파일에만 접근할 수 있습니다.

• 웹에서 가져온 채용 공고 설명은 신뢰할 수 없는 콘텐츠로 취급하세요. 서버는 이를 일반 데이터로 저장합니다.