Greenhouse MCP Server

Integrations

  • Provides tools for interacting with Greenhouse's recruitment and applicant tracking system, enabling job listing with filtering, candidate management with pagination, application tracking, and moving applications between stages.

온실 MCP 서버

Greenhouse Harvest API를 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버는 MCP를 통해 Greenhouse의 채용 및 지원자 추적 시스템과 상호 작용할 수 있는 도구를 제공합니다.

특징

  • 필터링 옵션을 사용하여 작업 나열
  • 페이지 번호로 후보자 나열
  • 필터링을 사용하여 애플리케이션 나열
  • 단계 간에 응용 프로그램 이동
  • 더 많은 기능이 곧 출시됩니다!

지역 개발 설정

  1. 종속성 설치:

지엑스피1

  1. 환경 변수 구성:
  • .env.example``.env 로 복사합니다.
  • .env 에 Greenhouse API 키를 추가합니다.
GREENHOUSE_API_KEY=your_api_key_here
  1. 프로젝트를 빌드하세요:
npm run build
  1. 서버를 시작합니다:
npm start

전개

GitHub 배포(권장)

  1. 이 저장소를 GitHub 계정으로 포크하거나 복제하세요.
  2. GitHub 저장소 비밀 설정:
    • 저장소의 설정 > 비밀 및 변수 > 작업으로 이동하세요.
    • API 키로 GREENHOUSE_API_KEY 라는 새 비밀을 추가합니다.
  3. GitHub Actions 활성화:
    • 저장소의 작업 탭으로 이동하세요
    • 워크플로가 아직 활성화되지 않은 경우 활성화합니다.
  4. 코드를 메인 브랜치에 푸시하세요.
git add . git commit -m "Initial commit" git push origin main
  1. GitHub Actions 워크플로는 자동으로 다음을 수행합니다.
    • 코드를 빌드하고 테스트하세요
    • Docker 이미지 생성
    • 이미지를 GitHub 컨테이너 레지스트리(ghcr.io)에 푸시합니다.
  2. 배포된 컨테이너를 사용하려면:
docker pull ghcr.io/your-username/mcp-greenhouse:latest docker run -p 3001:3001 -e GREENHOUSE_API_KEY=your_api_key ghcr.io/your-username/mcp-greenhouse:latest

로컬에서 Docker 사용

  1. 시스템에 Docker와 Docker Compose가 설치되어 있는지 확인하세요.
  2. 환경 구성:
    • .env 파일에 올바른 GREENHOUSE_API_KEY 포함되어 있는지 확인하세요.
    • .env 파일은 Docker Compose에서 환경 변수로 사용됩니다.
  3. 컨테이너를 빌드하고 시작합니다.
docker-compose up -d
  1. 로그를 확인하세요:
docker-compose logs -f
  1. 서버를 중지합니다:
docker-compose down

수동 배포

서버에 수동으로 배포하는 경우:

  1. 서버에 Node.js(v20 이상)를 설치하세요
  2. 저장소를 복제합니다.
git clone <repository-url> cd mcp-greenhouse
  1. 종속성 설치:
npm install
  1. 환경 변수 설정:
cp .env.example .env # Edit .env with your Greenhouse API key
  1. 프로젝트를 빌드하세요:
npm run build
  1. PM2로 시작하세요(생산에 권장):
npm install -g pm2 pm2 start dist/index.js --name mcp-greenhouse

사용 가능한 도구

일자리 목록

Greenhouse의 모든 작업을 나열하고, 선택적으로 상태 필터링을 적용할 수 있습니다.

매개변수:

  • status (선택 사항): 상태('열림', '닫힘', '초안')별로 작업을 필터링합니다.

후보자 목록

Greenhouse에 후보자를 나열하고 페이지 번호를 지원합니다.

매개변수:

  • per_page (선택 사항): 페이지당 후보자 수
  • page (선택 사항): 페이지 번호

목록_애플리케이션

필터링 옵션을 사용하여 Greenhouse의 애플리케이션을 나열합니다.

매개변수:

  • job_id (선택 사항): 작업 ID로 필터링
  • status (선택 사항): 애플리케이션 상태별 필터링

이동_신청

애플리케이션을 다른 단계로 이동합니다.

매개변수:

  • application_id (필수): 이동할 애플리케이션의 ID
  • stage_id (필수): 대상 스테이지의 ID

건강 검진

서버는 사용 가능한 도구 목록을 반환하는 /tools 에서 상태 점검 엔드포인트를 제공합니다.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

MIT

-
security - not tested
F
license - not found
-
quality - not tested

모델 컨텍스트 프로토콜을 통해 Greenhouse의 채용 및 지원자 추적 시스템과의 상호작용을 가능하게 하는 서버 구현으로, 구인 공고, 지원자 관리, 애플리케이션 필터링, 단계 전환을 위한 도구를 제공합니다.

  1. Features
    1. Local Development Setup
      1. Deployment
        1. GitHub Deployment (Recommended)
        2. Using Docker Locally
        3. Manual Deployment
      2. Available Tools
        1. list_jobs
        2. list_candidates
        3. list_applications
        4. move_application
      3. Health Check
        1. Contributing
          1. License
            ID: f0ye6eqs6u