ResumePilot MCP

Claude Desktop용 확장 가능한 범용 지원서 MCP 서버입니다.

Claude에게 마스터 이력서 하나를 주면 ResumePilot이 이를 파싱하고, 재사용 가능한 프로필을 구축하며, 이력서를 기준으로 채용 공고를 분석하고, 직무별 ATS/매칭 점수를 계산하며, 정보를 절대 지어내지 않는 맞춤형 이력서를 생성하고, 모든 지원 내역을 로컬 데이터베이스에 기록하며, 지원 건별 추적 페이지가 포함된 최종 PDF 보고서를 생성합니다.

1단계(이번 릴리스) 는 완전하고 테스트된 완전 로컬 기반입니다. 채용 공고를 붙여넣으면 전체 파이프라인이 엔드투엔드로 실행됩니다 — 외부 채용 사이트가 필요 없습니다. 글로벌 채용 검색, 지원 자동화, 이메일 추적은 동일한 어댑터 아키텍처에 연결되는 이후 단계입니다. docs/ARCHITECTURE.md를 참조하세요.

하지 않는 일

• ❌ 기술, 경력, 학력, 자격증, 수치를 절대 지어내지 않습니다.

• ❌ LinkedIn/Naukri 또는 기타 비밀번호나 OTP를 절대 저장하지 않습니다.

• ❌ CAPTCHA, 2FA, 봇 보호 또는 인증을 절대 우회하지 않습니다.

• ❌ 임의의 웹사이트에 자동 제출하지 않습니다(1단계는 준비만 하며, 제출은 사용자가 합니다).

필수 기술이 사용자 자료에서 검증될 수 없으면 ResumePilot은 *"필수 기술이 사용자 프로필에서 검증되지 않았습니다."*라고 보고합니다 — 추가하지 않습니다.

Related MCP server: resume-tailor-mcp-server

요구 사항

• Node.js ≥ 18.18

• Claude Desktop(MCP 사용 시)

설치 및 빌드

git clone <your-fork-url> resumepilot-mcp
cd resumepilot-mcp
npm install
npm run build
cp .env.example .env    # optional — sensible defaults otherwise

Claude 없이 사용해 보기(오프라인 데모)

Claude가 호출하는 것과 동일한 도구를 통해 전체 파이프라인을 임시 폴더에서 실행합니다:

npm run demo

원본→최적화 ATS 점수, 생성된 PDF 보고서, HTML 추적 페이지를 확인할 수 있습니다.

테스트 실행

npm test

40개의 테스트가 파싱, 점수 계산, "절대 지어내지 않음" 보장, 최적화, 추적, 보고, 엔드투엔드 도구 파이프라인을 다룹니다.

다운로드(Claude Desktop 확장 프로그램)

바로 설치 가능한 확장 프로그램을 Releases 페이지에서 받으세요:

확장 프로그램만 필요하신가요? resumepilot.mcpb 를 다운로드하고 Claude Desktop → 설정 → 확장 프로그램을 열어 파일을 드래그하고, 데이터 폴더를 설정한 뒤 켜기로 전환하세요.

Claude Desktop에 설치

두 가지 방법 — 전체 가이드는 docs/INSTALL.md 에 있습니다:

• 원클릭 데스크톱 확장 프로그램: npm run bundle로 resumepilot.mcpb를 생성하고, Claude Desktop → 설정 → 확장 프로그램으로 드래그한 뒤 데이터 폴더를 설정하고 켜기로 전환하세요. (번들에 네이티브 SQLite 바이너리가 포함되므로 macOS/Windows용으로는 자신의 OS에서 한 번의 명령으로 빌드하세요.)

• 수동 MCP 설정: 소스에서 빌드하고 mcpServers 항목을 추가하세요.

Claude Desktop에 연결(수동 설정)

1. 빌드: npm run build(dist/src/index.js 생성).

2. Claude Desktop 설정 파일을 엽니다:

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

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 절대 경로를 사용하여 서버를 추가합니다(docs/claude_desktop_config.example.json 참조):

   {
     "mcpServers": {
       "resumepilot": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/resumepilot-mcp/dist/src/index.js"],
         "env": {
           "RESUMEPILOT_DATA_DIR": "/ABSOLUTE/PATH/TO/your-private-data",
           "ATS_TARGET_SCORE": "90"
         }
       }
     }
   }

4. Claude Desktop을 완전히 종료하고 다시 엽니다. ResumePilot의 도구가 도구(🔌) 메뉴에 나타납니다.

사용 방법

이렇게 말해 보세요:

"ResumePilot 지원서 프로세스를 시작해 줘."

Claude는 워크플로를 이해하고 다음을 수행합니다:

1. 마스터 이력서를 요청 → upload_master_resume(파일 경로 제공).

2. 이력서를 파싱하고 누락된 정보만 요청 → analyze_master_resume → setup_user_profile.

3. 붙여넣은 채용 공고를 받아 → analyze_job(원본 ATS + 격차 표시).

4. 맞춤형 이력서를 작성 → optimize_resume_for_job(원본 vs 최적화 ATS, PDF + DOCX).

5. 지원서를 준비 → generate_application_profile → prepare_application.

6. 기록 → apply_to_job(1단계: 사용자가 제출하고, 확인 시 Claude가 APPLIED로 표시).

7. 추적 → update_application_tracking / search_application_emails.

8. 최종 보고서 생성 → generate_application_report(PDF + 추적 페이지).

예시 프롬프트

• "여기 내 이력서가 있어: /Users/me/Documents/resume.pdf. 내 프로필을 설정해 줘."

• "이 채용 공고를 내 이력서와 비교해 분석해 줘: <채용 공고 붙여넣기>"

• "지원 1번에 맞게 이력서를 최적화하고 전후 ATS 점수를 보여 줘."

• "무엇이 바뀌었고, 무엇을 검증할 수 없었어?"

• "내 지원 보고서를 생성해 줘."

설정(.env)

보안 및 개인정보 보호

• 데이터는 RESUMEPILOT_DATA_DIR(git 무시) 아래 사용자 머신에만 저장됩니다.

• 제3자 비밀번호나 OTP는 절대 저장되지 않으며, 향후 통합은 공식 OAuth/세션 흐름을 사용하고 토큰은 로그에 남기지 않습니다.

• 로그는 stderr로만 출력되며 비밀번호처럼 보이는 값은 마스킹합니다.

• 데이터 디렉터리를 삭제하면 언제든 데이터를 제거할 수 있습니다.

프로젝트 구조

src/
├── index.ts, server.ts          # MCP stdio server + tool registration
├── context.ts                   # composition root
├── tools/                       # 17 MCP tools (thin, Zod-validated)
├── services/                    # parsing, scoring, optimization, tracking, reports
├── providers/                   # jobs / applications / email adapters (+ registries)
├── database/                    # SQLite schema + repository
├── models/                      # Zod schemas & types
└── utils/                       # config, logger, text/keyword processing, ids
tests/                           # vitest suite (40 tests)
docs/                            # ARCHITECTURE.md, Claude Desktop config
scripts/demo.ts                  # offline end-to-end demo

로드맵

2단계: 범용 검색 어댑터, 워커 풀, 중복 제거, 순위 지정, 최대 1,000개 작업 · 3단계: 지원되는 채용 소스 통합 · 4단계: 지원 어댑터 · 5단계: Gmail 추적(OAuth) · 6단계: 호스팅 추적 UI + 패키징.

라이선스

MIT — LICENSE 참조.