Greenhouse MCP Server

Servidor MCP de invernadero

Implementación de un servidor de Protocolo de Contexto de Modelo (MCP) para la API de Greenhouse Harvest. Este servidor proporciona herramientas para interactuar con el sistema de reclutamiento y seguimiento de candidatos de Greenhouse a través de MCP.

Características

• Lista de trabajos con opciones de filtrado
• Lista de candidatos con paginación
• Lista de aplicaciones con filtrado
• Mover aplicaciones entre etapas
• ¡Pronto habrá más funciones!

Configuración de desarrollo local

1. Instalar dependencias:

2. Configurar variables de entorno:

• Copiar .env.example a .env
• Agregue su clave API de Greenhouse a .env :

3. Construir el proyecto:

4. Iniciar el servidor:

Despliegue

Implementación de GitHub (recomendada)

1. Bifurca o clona este repositorio en tu cuenta de GitHub.
2. Configurar los secretos del repositorio de GitHub:
   • Vaya a Configuración de su repositorio > Secretos y variables > Acciones
   • Agregue un nuevo secreto llamado GREENHOUSE_API_KEY con su clave API
3. Habilitar acciones de GitHub:
   • Vaya a la pestaña Acciones de su repositorio
   • Habilitar flujos de trabajo si aún no están habilitados
4. Envía tu código a la rama principal:

5. El flujo de trabajo de GitHub Actions realizará automáticamente lo siguiente:
   • Construye y prueba tu código
   • Crear una imagen de Docker
   • Subir la imagen al Registro de contenedores de GitHub (ghcr.io)
6. Para utilizar el contenedor implementado:

Usando Docker localmente

1. Asegúrese de tener Docker y Docker Compose instalados en su sistema.
2. Configura tu entorno:
   • Asegúrese de que su archivo .env contenga la GREENHOUSE_API_KEY correcta
   • Docker Compose utilizará el archivo .env para las variables de entorno
3. Construya e inicie el contenedor:

4. Revisar los registros:

5. Detener el servidor:

Implementación manual

Para la implementación manual en un servidor:

1. Instale Node.js (v20 o posterior) en su servidor
2. Clonar el repositorio:

3. Instalar dependencias:

4. Configurar variables de entorno:

5. Construir el proyecto:

6. Comience con PM2 (recomendado para producción):

Herramientas disponibles

lista_de_trabajos

Enumera todos los trabajos en Greenhouse con filtrado de estado opcional.

Parámetros:

• status (opcional): Filtrar trabajos por estado ('abierto', 'cerrado', 'borrador')

lista_de_candidatos

Enumera candidatos en Greenhouse con soporte de paginación.

Parámetros:

• per_page (opcional): Número de candidatos por página
• page (opcional): Número de página

lista_aplicaciones

Enumera las aplicaciones en Greenhouse con opciones de filtrado.

Parámetros:

• job_id (opcional): Filtrar por ID de trabajo
• status (opcional): Filtrar por estado de la aplicación

mover_aplicación

Mueve una aplicación a una etapa diferente.

Parámetros:

• application_id (obligatorio): ID de la aplicación a mover
• stage_id (obligatorio): ID de la etapa de destino

Chequeo de salud

El servidor proporciona un punto final de verificación de estado en /tools que devuelve la lista de herramientas disponibles.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Instituto Tecnológico de Massachusetts (MIT)