온실 MCP 서버

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

특징

• 필터링 옵션을 사용하여 작업 나열

• 페이지 번호로 후보자 나열

• 필터링을 사용하여 애플리케이션 나열

• 단계 간에 응용 프로그램 이동

• 더 많은 기능이 곧 출시됩니다!

Related MCP server: MCP Ashby Connector

지역 개발 설정

1. 종속성 설치:

지엑스피1

2. 환경 변수 구성:

• .env.example``.env 로 복사합니다.

• .env 에 Greenhouse API 키를 추가합니다.

GREENHOUSE_API_KEY=your_api_key_here

3. 프로젝트를 빌드하세요:

npm run build

4. 서버를 시작합니다:

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

5. GitHub Actions 워크플로는 자동으로 다음을 수행합니다.

   • 코드를 빌드하고 테스트하세요

   • Docker 이미지 생성

   • 이미지를 GitHub 컨테이너 레지스트리(ghcr.io)에 푸시합니다.

6. 배포된 컨테이너를 사용하려면:

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

4. 로그를 확인하세요:

docker-compose logs -f

5. 서버를 중지합니다:

docker-compose down

수동 배포

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

1. 서버에 Node.js(v20 이상)를 설치하세요

2. 저장소를 복제합니다.

git clone <repository-url>
cd mcp-greenhouse

3. 종속성 설치:

npm install

4. 환경 변수 설정:

cp .env.example .env
# Edit .env with your Greenhouse API key

5. 프로젝트를 빌드하세요:

npm run build

6. 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