Servidor MCP de HireBase

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona herramientas para interactuar con la API de trabajo de HireBase.

Interacciones MCP disponibles

Este servidor expone las siguientes interacciones MCP:

Herramientas

• search_jobs : busque trabajos utilizando la API de HireBase según varios criterios (palabras clave, título, ubicación, salario, etc.).
  • Parámetros : 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 : recupera información detallada sobre un trabajo específico utilizando su ID de HireBase.
  • Parámetros : job_id .

Indicaciones

• create_candidate_profile : genera un mensaje estructurado basado en los detalles del candidato (nombre, LinkedIn, sitio web, texto del currículum) para ayudar a guiar la búsqueda de empleo.
  • Parámetros : name , linkedin_url , personal_website , resume_text .

Configuración del cliente (ejemplos: Claude Desktop, Cursor)

Para utilizar este servidor con un cliente MCP como Claude Desktop o Cursor, debe configurar el cliente para ejecutar el proceso del servidor y, opcionalmente, proporcionar la clave API de HireBase.

1. Asegúrese de que uv esté instalado: curl -LsSf https://astral.sh/uv/install.sh | sh
2. Obtener una clave API de HireBase (opcional): solicitar una clave de HireBase. Puede configurarla como una variable de entorno ( HIREBASE_API_KEY ) o simplemente dejarla vacía.
3. Configura tu cliente:
   • Usando uvx :
     • Claude Desktop: edita tu claude_desktop_config.json :
       { "mcpServers": { "hirebase": { "command": "uvx", "args": [ "hirebase-mcp" ], "env": { "HIREBASE_API_KEY": "" } } } }
     • Cursor: Vaya a Configuración > MCP > Agregar servidor:
       • Comando Mac/Linux: uvx hirebase-mcp (Ajuste el nombre del paquete si es necesario)
       • Comando de Windows: cmd
       • Argumentos de Windows: /c , uvx , hirebase-mcp (ajuste el nombre del paquete si es necesario)
       • Establezca la variable de entorno HIREBASE_API_KEY en la sección adecuada.
   • Ejecución desde la fuente a través de Python (alternativa):
     1. Clona el repositorio y anota dónde lo clonas
     2. Claude Desktop: edita tu claude_desktop_config.json : GXP2

Desarrollo

Este proyecto utiliza:

• uv para gestión de dependencias y entornos virtuales
• ruff para deshilachado y formateo
• hatch como backend de compilación

Tareas comunes

Variables de entorno

• HIREBASE_API_KEY ( obligatorio ): Su clave API para acceder a la API de HireBase. El servidor la necesita para realizar solicitudes autenticadas de datos de trabajo.

Pruebas

Este proyecto utiliza pytest para probar la lógica de la herramienta principal. Las pruebas simulan llamadas a la API externa mediante unittest.mock .

1. Instalar dependencias de prueba:

2. Ejecutar pruebas:

Contribuyendo

Las contribuciones son bienvenidas.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.