job-mcp-server

기획재정부(공공기관 경영정보 공개시스템, 알리오) 채용정보 조회서비스 Open API를 호출하는 MCP(Model Context Protocol) 서버입니다.

사전 준비: 서비스키 발급

1. 공공데이터포털 회원가입
2. 기획재정부_공공기관 채용정보 조회서비스 활용신청
3. 승인 완료 후 마이페이지 > 활용신청 현황에서 서비스키(일반 인증키, Decoding) 확인
4. 아래 환경변수에 설정

설치 및 빌드

git clone https://github.com/iapke486-arch/job-mcp-server.git
cd job-mcp-server

npm install
npm run build

실행

직접 실행 (테스트)

JOB_API_KEY=발급받은서비스키 node build/index.js

Windows PowerShell:

$env:JOB_API_KEY = "발급받은서비스키"
node build/index.js

Claude Desktop / Claude Code 설정

Claude Desktop

claude_desktop_config.json(보통 %APPDATA%\Claude\claude_desktop_config.json)에 아래와 같이 등록합니다.

{
  "mcpServers": {
    "job": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/job-mcp-server/build/index.js"],
      "env": {
        "JOB_API_KEY": "발급받은서비스키"
      }
    }
  }
}

경로 예시:

• Windows: C:/Users/YourName/Documents/pke/job-mcp-server/build/index.js
• macOS/Linux: /home/username/projects/job-mcp-server/build/index.js

Claude Code CLI

claude mcp add --env JOB_API_KEY=발급받은서비스키 -- node /path/to/job-mcp-server/build/index.js

연결 확인

Claude Code: /mcp 목록에서 job 서버가 ✓ Connected 상태인지 확인하세요.

제공 도구 (Tools)

Tool	설명
job_search_recruitments	공공기관 채용공고 목록 조회. 고용형태/채용구분/근무지역/NCS 직무분야/학력조건/진행중여부로 필터링, 기관명·제목 키워드로 클라이언트 측 부분 필터링 지원
job_get_codes	필터에 사용하는 공통코드(고용형태, 채용구분, 근무지역, NCS 분류, 학력조건, 첨부유형, 기관유형, 주무부처) 조회

참고

• 원본 API는 JSON을 직접 지원하므로 별도 XML 파싱 없이 그대로 반환합니다.
• 기관명(instNm)·공고제목(recrutPbancTtl) 키워드 검색은 API 자체에서 지원하지 않아, job_search_recruitments가 조회된 페이지(numOfRows) 범위 내에서만 부분 일치로 필터링합니다. 특정 기관/제목을 폭넓게 찾으려면 numOfRows를 늘리거나 pblntInstCd 등 서버 필터를 함께 사용하세요.
• 코드값(hireTypeLst, recrutSe, workRgnLst, ncsCdLst, acbgCondLst)은 job_get_codes로 조회한 값을 사용해야 합니다. 출처: MOEF_NKOD_DB_05_코드 정의서_v1.2.
• 서비스키가 만료되었거나 잘못된 경우, API가 반환하는 원본 오류 메시지를 그대로 전달합니다.