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!

Related MCP server: MCP Ashby Connector

Configuración de desarrollo local

1. Instalar dependencias:

npm install

2. Configurar variables de entorno:

• Copiar .env.example a .env

• Agregue su clave API de Greenhouse a .env :

GREENHOUSE_API_KEY=your_api_key_here

3. Construir el proyecto:

npm run build

4. Iniciar el servidor:

npm start

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:

git add .
git commit -m "Initial commit"
git push origin main

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:

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

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:

docker-compose up -d

4. Revisar los registros:

docker-compose logs -f

5. Detener el servidor:

docker-compose down

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:

git clone <repository-url>
cd mcp-greenhouse

3. Instalar dependencias:

npm install

4. Configurar variables de entorno:

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

5. Construir el proyecto:

npm run build

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

npm install -g pm2
pm2 start dist/index.js --name mcp-greenhouse

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)