job-mcp

FastMCP 서버(stdio 전송)이며 다음을 제공합니다:

• 리소스 cv://profile — LLM 클라이언트가 읽을 수 있는 사용자의 이력서(CV/resume)를 JSON으로 제공합니다.

• 도구 send_email — Red Mail을 사용해 SMTP로 이메일을 전송합니다.

작업 흐름: MCP 클라이언트에게 채용 공고와 채용 담당자 이메일을 채팅으로 제공하면 → 클라이언트가 cv://profile을 읽고 → 맞춤 지원 이메일을 작성한 다음 → send_email을 호출해 전송합니다.

1. 설치

cd job-mcp
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

Related MCP server: MCP Server

2. SMTP 자격 증명 설정

cp .env.example .env

.env 파일에서 SMTP 호스트와 자격 증명을 수정하세요. Gmail의 경우 일반 로그인 비밀번호가 아닌 앱 비밀번호를 사용하고, 먼저 2단계 인증을 활성화하세요.

3. 이력서 작성

src/job_mcp/data/cv.json을 실제 정보(연락처, 기술, 경력, 학력, 프로젝트, 자격증)로 수정하세요. 리소스는 이 파일을 있는 그대로 읽습니다.

4. 서버를 단독 실행(기본 동작 확인)

python -m job_mcp.server

서버는 stdin/stdout에서 MCP JSON-RPC 메시지를 기다리며 대기합니다(정상입니다 — MCP 클라이언트에 의해 실행되도록 만들어진 것이지, 대화형으로 사용되는 것이 아닙니다).

MCP 개발 인스펙터로도 검사할 수 있습니다:

mcp dev src/job_mcp/server.py

5. MCP 클라이언트에 연결

stdio로 서버를 실행하는 클라이언트용 구성 예시(예: Claude Desktop의 claude_desktop_config.json):

{
  "mcpServers": {
    "job-mcp": {
      "command": "/absolute/path/to/job-mcp/.venv/bin/python",
      "args": ["-m", "job_mcp.server"],
      "env": {
        "SMTP_HOST": "smtp.gmail.com",
        "SMTP_PORT": "587",
        "SMTP_USERNAME": "you@gmail.com",
        "SMTP_PASSWORD": "your-app-password",
        "SMTP_SENDER_EMAIL": "you@gmail.com",
        "SMTP_SENDER_NAME": "Your Name"
      }
    }
  }
}

(자격 증명은 .env 대신 여기의 env에 넣어도 됩니다. config.py가 어느 쪽이든 os.environ에서 읽으므로 둘 다 동작합니다.)

6. 사용하기

클라이언트에 다음과 같이 붙여넣으세요:

여기 채용 공고와 채용 담당자의 이메일이 있습니다. 내 이력서 리소스를 읽은 다음 맞춤 지원 이메일을 작성해서 보내 주세요.

채용 공고: 채용 담당자 이메일: hr@company.com

클라이언트는 cv://profile을 호출하고 두 가지 맥락을 모두 사용해 이메일을 작성한 다음 send_email(to=..., subject=..., body_html=..., body_text=...)을 호출해야 합니다.

참고 사항 / 나중에 보강할 내용

• send_email에는 현재 서버 자체에 확인 단계가 내장되어 있지 않습니다. "보내기 전 검토" 가드레일을 클라이언트 측이 아닌 서버 측에서 적용하려면 두 단계 흐름을 추가하세요(예: 미리보기와 ID를 반환하는 draft_email 도구와 실제로 전송하는 confirm_send 도구).

• 실수로 중복 전송되는 것을 방지하기 위해 전송된 이메일의 속도 제한 또는 로깅을 고려하세요.

• cv.json은 리소스를 호출할 때마다 새로 읽으므로 서버를 재시작하지 않고도 수정할 수 있습니다.