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.

Licencia: MIT

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 .

Related MCP server: Careerjet Job Search MCP Server

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.

Asegúrese de que curl -LsSf https://astral.sh/uv/install.sh | sh
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.
Configura tu cliente:
- Usando
  - 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

# Setup virtual env uv venv # Install dependencies uv pip install -e . # install cli tools uv tool install ruff # Run linting ruff check . # Format code ruff format .

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 .