HireBase MCP 서버

HireBase Job API와 상호 작용할 수 있는 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.

사용 가능한 MCP 상호 작용

이 서버는 다음과 같은 MCP 상호작용을 제공합니다.

도구

• search_jobs : HireBase API를 사용하여 다양한 기준(키워드, 직함, 위치, 급여 등)에 따라 일자리를 검색합니다.
  • 매개변수 : query , and_keywords , or_keywords , not_keywords , title , category , country , city , location_type , company , salary_from , salary_to , salary_currency , years_from , years_to , visa , limit .
• get_job : HireBase ID를 사용하여 특정 직무에 대한 자세한 정보를 검색합니다.
  • 매개변수 : job_id .

프롬프트

• create_candidate_profile : 후보자 세부 정보(이름, LinkedIn, 웹사이트, 이력서 내용)를 기반으로 구조화된 프롬프트를 생성하여 구직 활동을 안내합니다.
  • 매개변수 : name , linkedin_url , personal_website , resume_text .

클라이언트 설정(예: Claude Desktop, Cursor)

Claude Desktop이나 Cursor와 같은 MCP 클라이언트와 함께 이 서버를 사용하려면 클라이언트를 구성하여 서버 프로세스를 실행하고 선택적으로 HireBase API 키를 제공해야 합니다.

1. uv 설치되었는지 확인하세요: curl -LsSf https://astral.sh/uv/install.sh | sh
2. HireBase API 키 얻기(선택 사항): HireBase 에서 키를 요청합니다. 이를 환경 변수( HIREBASE_API_KEY )로 설정하거나 그냥 비워둘 수 있습니다.
3. 클라이언트를 구성하세요:
   • uvx 사용:
     • Claude Desktop: claude_desktop_config.json 편집하세요:지엑스피1
     • 커서: 설정 > MCP > 서버 추가로 이동하세요.
       • Mac/Linux 명령: uvx hirebase-mcp (필요한 경우 패키지 이름 조정)
       • Windows 명령: cmd
       • Windows 인수: /c , uvx , hirebase-mcp (필요한 경우 패키지 이름 조정)
       • 해당 섹션에서 HIREBASE_API_KEY 환경 변수를 설정합니다.
   • Python을 통해 소스에서 실행(대안):
     1. 저장소를 복제하고 복제한 위치를 기록하세요.
     2. Claude Desktop: claude_desktop_config.json 편집하세요: GXP2

개발

이 프로젝트에서는 다음을 사용합니다.

• 종속성 관리 및 가상 환경을 위한 uv
• 린팅 및 포맷팅을 위한 ruff
• 빌드 백엔드로 hatch

일반적인 작업

환경 변수

• HIREBASE_API_KEY ( 필수 ): HireBase API에 액세스하는 데 필요한 API 키입니다. 서버에서 채용 정보 데이터에 대한 인증된 요청을 하려면 이 키가 필요합니다.

테스트

이 프로젝트에서는 핵심 도구 로직을 테스트하기 위해 pytest 사용합니다. unittest.mock 사용하여 외부 API 호출을 모의 테스트합니다.

1. 테스트 종속성 설치:

2. 테스트 실행:

기여하다

기여를 환영합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.