MCP Job Radar

영어 · 포르투갈어

채용 정보 탐색과 설명 가능한 매칭을 위한 안전하고 읽기 전용인 Model Context Protocol 서버입니다.

채용 설명에는 프롬프트 인젝션, 명령어, 비밀 요청, 악성 링크가 포함될 수 있습니다. 이 서버는 신뢰할 수 없는 목록을 명령 채널로 바꾸지 않으면서 AI 호스트에 채용 검색 기능을 노출합니다. 모든 도구는 타입이 지정되고, 범위가 제한되며, 감사되고, 읽기 전용이며, 실제 인메모리 MCP 클라이언트를 통해 실행됩니다.

리뷰어가 3분 안에 검증할 수 있는 것

uv sync --extra dev
uv run pytest
uv run mcp-job-radar-demo

데모는 공식 MCP 클라이언트를 서버에 연결하고, tools/list를 통해 도구를 발견하고, search_jobs를 호출하고, 구조화된 결과를 출력합니다. 테스트는 도구 발견, JSON Schema, 결정적 순위, 타입 오류, 시간 초과, 재시도, 회로 차단, 적대적 콘텐츠를 다룹니다.

Related MCP server: LinkedIn Jobs MCP Server

도구

모든 입력과 출력은 엄격한 Pydantic 모델을 사용합니다. 잘못되었거나, 누락되었거나, 중복되거나, 과도한 입력은 구현 역추적 대신 안정적인 기계 판독 가능 오류를 생성합니다.

아키텍처

flowchart LR
    H[AI host] -->|MCP| M[MCP adapter]
    M --> A[Safe audit boundary]
    A --> S[Typed job service]
    S --> R[Deterministic ranker]
    S --> G[Untrusted-content gateway]
    S --> D[Timeout, retry, circuit breaker]
    D --> F[(Normalized fixtures)]
    G -->|bounded and redacted| M

MCP 어댑터에는 순위 로직이 없습니다. 애플리케이션 서비스는 사용 사례를, 보안 게이트웨이는 신뢰 경계를, 저장소는 소스 복원력을 담당합니다. 이러한 분리는 프로토콜을 교체 가능하게 하고 중요한 정책을 독립적으로 테스트 가능하게 합니다.

전체 아키텍처 및 위협 모델과 적대적 테스트 매트릭스를 읽어보세요.

보안 통제

• 채용 설명은 에이전트 컨텍스트에 들어가기 전에 범위가 제한되고, 정규화되고, 스캔되고, 수정됩니다.

• 프롬프트 인젝션 문구, 비밀 요청, 명령어, 포함된 URL은 명시적 발견 사항이 됩니다.

• 목록 URL은 공개 HTTPS를 사용해야 하며 자격 증명을 포함하거나 로컬/개인 호스트를 대상으로 할 수 없습니다.

• 결과 수와 배치 ID는 25개로 제한됩니다.

• 소스 접근에는 시간 초과, 제한된 재시도, 프로세스 내 회로 차단기가 있습니다.

• 감사 이벤트에는 도구 이름, 상태, 지속 시간, 오류 유형이 포함되며 인수나 결과 본문은 포함되지 않습니다.

• 의도적으로 명령 실행, 임의 가져오기, 로컬 파일 읽기, 자동 지원, 영구 내보내기 기능이 없습니다.

예제 요청

{
  "job_ids": ["remoteok-1001", "remotive-3003"],
  "profile": {
    "target_titles": ["AI Engineer", "AI Solutions Architect"],
    "skills": ["Python", "RAG", "LLM", "MCP"],
    "remote_required": true,
    "seniority": "senior",
    "minimum_salary_brl": 20000
  },
  "limit": 10
}

결과는 숫자 점수와 긍정 신호 및 명시적 트레이드오프를 포함합니다. 설명은 동일한 점수 함수로 생성되므로 순위에서 벗어날 수 없습니다.

MCP 서버로 실행

기본 전송은 stdio입니다:

uv run mcp-job-radar

호스트 구성 예시:

{
  "mcpServers": {
    "job-radar": {
      "command": "uv",
      "args": ["--directory", "ABSOLUTE_PATH_TO_REPOSITORY", "run", "mcp-job-radar"]
    }
  }
}

프로젝트는 공식 Python SDK v2와 현재 MCP 2026-07-28 프로토콜 라인을 사용합니다. 자동화된 통합 테스트는 Python 함수를 직접 호출하는 대신 SDK의 인메모리 클라이언트인 Client(mcp)를 사용합니다.

radar-de-vagas와의 관계

radar-de-vagas는 6개의 공개 소스에서 수집, 2계층 관련성 필터링, 정규화, 전역 중복 제거, 우선순위 정렬을 담당합니다. mcp-job-radar는 에이전트 지향 계약과 보안 경계를 추가합니다. 체크인된 정규화 데이터셋은 테스트를 결정적으로 만들고 CI가 스크래핑, 자격 증명, 속도 제한, 타사 중단과 독립적으로 유지되게 합니다.

측정된 동작

승인 스위트는 다음을 검증합니다:

• 정확히 4개의 발견 가능한 MCP 도구;

• 구조화된 MCP 결과 및 생성된 입력 스키마;

• 반복 가능한 순위 및 매칭 설명;

• 정의된 모든 적대적 콘텐츠 클래스가 수정됨;

• 안전하지 않은 URL 클래스가 거부됨;

• 잘못된 형식 및 느린 소스가 타입 재시도 가능 실패로 반환됨;

• 자동 지원 또는 영구 쓰기 표면 없음.

커버리지는 CI에서 85%로 강제됩니다. README는 저장소가 주장하는 동작만 보고하며, 프로덕션 트래픽이나 합성 비즈니스 정확성 주장은 보고하지 않습니다.

검증 기반 조정

• 구현은 설치된 MCP SDK v2 API에 맞춰 정렬되었으며, 통합 테스트가 이동된 ToolError 경계와 타입 list_tools() 응답 봉투를 검증한 후에 이루어졌습니다.

• 정규화된 픽스처는 빌드된 휠을 검사한 후 Python 패키지 내부로 이동되었습니다. 이는 편집 가능한 소스 체크아웃에서만 작동하는 데모를 방지합니다.

• 읽기 전용, 비파괴적, 멱등적, 폐쇄 세계 주석이 발견된 4개 도구 모두에 대해 주장되므로 게시된 메타데이터는 문서화만 되는 것이 아니라 확인됩니다.

제한 사항 및 다음 단계

• 데모 데이터는 합성적이고 정규화되었습니다. 에이전트 경계를 증명하지만 라이브 소스 가동 시간은 증명하지 않습니다.

• 순위는 어휘 및 정책 기반입니다. 의미적 동등성과 경력 뉘앙스는 v0.1 범위 밖입니다.

• 회로 차단기는 프로세스 로컬입니다. 분산 배포에는 공유 상태와 메트릭이 필요합니다.

• 라이브 어댑터는 radar-de-vagas의 버전이 지정된 정규화 출력을 소비해야 하며, 스크립트를 가져오거나 소스별 스크래핑을 중복해서는 안 됩니다.

• 인증 및 Streamable HTTP 배포는 이 로컬 stdio 데모에서 의도적으로 제외되었습니다. 신뢰할 수 있는 호스트 너머로 서버를 노출할 때만 필요해집니다.

AI 지원 공개

저장소는 AI 지원 구현 및 검토로 개발되었습니다. 아키텍처, 보안 주장, 테스트, 제한 사항, 게시된 아티팩트는 실행 가능한 동작에 대해 확인되었습니다. 저작권 책임과 최종 기술 결정은 Raphael Caveagna에게 있습니다.