job-mcp

Un servidor FastMCP (transporte stdio) con:

• Recurso cv://profile — tu CV/currículum como JSON, para que el cliente LLM lo lea.

• Herramienta send_email — envía un correo electrónico por SMTP usando Red Mail.

Flujo de trabajo: le das al cliente MCP una oferta de empleo + el correo del reclutador en el chat → el cliente lee cv://profile → redacta un correo de solicitud personalizado → llama a send_email para enviarlo.

1. Instalación

cd job-mcp
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

Related MCP server: MCP Server

2. Configura las credenciales SMTP

cp .env.example .env

Edita .env con tu host/credenciales SMTP. Para Gmail, usa una App Password (no tu contraseña de inicio de sesión normal), y activa primero la verificación en dos pasos.

3. Rellena tu CV

Edita src/job_mcp/data/cv.json con tus datos reales (información de contacto, habilidades, experiencia, educación, proyectos, certificaciones). El recurso simplemente lee este archivo tal cual.

4. Ejecuta el servidor de forma independiente (prueba de funcionamiento)

python -m job_mcp.server

Se quedará a la espera de mensajes JSON-RPC de MCP en stdin/stdout (es normal: está pensado para que lo lance un cliente MCP, no para usarse de forma interactiva).

También puedes inspeccionarlo con el inspector de desarrollo de MCP:

mcp dev src/job_mcp/server.py

5. Conéctalo a un cliente MCP

Configuración de ejemplo para un cliente que lanza servidores a través de stdio (p. ej. el claude_desktop_config.json de Claude Desktop):

{
  "mcpServers": {
    "job-mcp": {
      "command": "/absolute/path/to/job-mcp/.venv/bin/python",
      "args": ["-m", "job_mcp.server"],
      "env": {
        "SMTP_HOST": "smtp.gmail.com",
        "SMTP_PORT": "587",
        "SMTP_USERNAME": "you@gmail.com",
        "SMTP_PASSWORD": "your-app-password",
        "SMTP_SENDER_EMAIL": "you@gmail.com",
        "SMTP_SENDER_NAME": "Your Name"
      }
    }
  }
}

(Puedes poner las credenciales en env aquí en lugar de en .env — cualquiera de las dos funciona, ya que config.py lee de os.environ de todas formas.)

6. Úsalo

En el cliente, pega algo como:

Aquí tienes una oferta de empleo y el correo del reclutador. Lee mi recurso CV y luego redacta y envía un correo de solicitud personalizado.

Oferta de empleo: Correo del reclutador: hr@company.com

El cliente debería llamar a cv://profile, redactar el correo usando ambos elementos de contexto, y llamar a send_email(to=..., subject=..., body_html=..., body_text=...).

Notas / aspectos a reforzar más adelante

• send_email actualmente no tiene un paso de confirmación integrado en el propio servidor — si quieres una salvaguarda de "revisar antes de enviar" impuesta en el lado del servidor (no solo en el lado del cliente), añade un flujo de dos pasos (p. ej. una herramienta draft_email que devuelva una vista previa + un id, y una herramienta confirm_send que realmente lo envíe).

• Considera aplicar rate-limiting o registrar los correos enviados para evitar envíos duplicados accidentales.

• cv.json se lee de nuevo en cada llamada al recurso, por lo que puedes editarlo sin reiniciar el servidor.