Proxy MCP de NextRole

Un servidor proxy del Protocolo de Contexto de Modelo (MCP) que proporciona acceso a los servicios profesionales de adaptación de CV y cartas de presentación de NextRole. Este proxy permite a los clientes compatibles con MCP interactuar con los servicios alojados de NextRole.

Características

• Adaptación profesional de CV: Personaliza tu CV para solicitudes de empleo específicas

• Generación de cartas de presentación: Crea cartas de presentación adaptadas que coincidan con los requisitos del puesto

• Múltiples niveles de servicio: Servicios profesionales de nivel inicial, intermedio y superior

• Gestión de créditos: Realiza un seguimiento y gestiona tus créditos de servicio

• Soporte internacional: Disponible para usuarios de todo el mundo

Instalación

Desde el código fuente

Clona el repositorio y ejecuta el script de instalación. Instalará las dependencias, compilará el proyecto e imprimirá el JSON de configuración del cliente MCP para ti.

git clone https://github.com/bats64mgutsi/nextrole-mcp-proxy.git
cd nextrole-mcp-proxy

Linux / macOS:

bash install.sh

Windows (PowerShell):

.\install.ps1

Al final del script, verás el JSON de configuración del cliente MCP con la ruta correcta a tu instalación local. Cópialo en el archivo de configuración de tu cliente MCP.

Con npx (sin instalación local)

Añádelo a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "nextrole": {
      "command": "npx",
      "args": ["nextrole-mcp-proxy"]
    }
  }
}

Uso

Herramientas disponibles

1. get_pricing

Obtén los niveles de carrera disponibles y sus IDs de producto. Debes llamar a esto antes de realizar un pedido para obtener el productId correcto.

Uso:

What are your different CV tailoring packages?

Respuesta:

[
  {
    "CountryCode": "ZA", 
    "ServiceTier": "Entry Level",
    "ProductId": 1
  },
  {
    "CountryCode": "ZA",
    "ServiceTier": "Mid Level", 
    "ProductId": 2
  },
  {
    "CountryCode": "ZA",
    "ServiceTier": "Senior Level",
    "ProductId": 3
  }
]

2. get_credits

Comprueba cuántos créditos le quedan a un cliente. Cada pedido cuesta 1 crédito.

Parámetros:

• phoneNumber (obligatorio): Número de teléfono del cliente incluyendo el código de país (ej. +27831234567)

Uso:

How many credits do I have left? My phone number is +27831234567

Respuesta:

{
  "credits": 5
}

3. place_order

Realiza un pedido para un CV y una carta de presentación adaptados. El pedido suele tardar unos 15 minutos en completarse. El cliente recibirá notificaciones por SMS cuando se confirme el pedido y cuando los documentos estén listos. Cuesta 1 crédito por pedido.

Parámetros:

• customerPhone (obligatorio): Número de teléfono del cliente incluyendo el código de país, debe comenzar con '+' (ej. +27831234567)

• customerFirstName (obligatorio): Nombre del cliente

• customerLastName (obligatorio): Apellido del cliente

• cvMarkdown (obligatorio): El CV actual del cliente en formato markdown

• productId (obligatorio): El ID de producto que coincide con el nivel profesional del cliente (llama primero a get_pricing)

• jobDescription (obligatorio): La descripción completa del puesto al que aplica el cliente

Uso:

I need to tailor my CV for a Junior Software Developer position. My phone number is +27831234567, my name is John Smith, and here's my current CV in markdown:

# John Smith
## Experience
- Junior Developer at TechCorp (2023-present)

The job description is: We are seeking a Junior Software Developer to join our team with React and Node.js experience.

Respuesta:

{
  "orderKey": "550e8400-e29b-41d4-a716-446655440000",
  "status": "success",
  "message": "Order placed successfully. SMS notifications sent."
}

Casos de uso de ejemplo

Profesional de nivel inicial

Perfecto para recién graduados y profesionales al inicio de su carrera:

I'm Sarah Johnson (+44207123456) and need my CV tailored for this graduate software engineer role: Graduate Software Engineer requiring Python programming and problem-solving skills. 

My current CV:
# Sarah Johnson
## Education
- Computer Science Degree, University of London (2024)
## Projects  
- Built a web application using Python and Flask

Cambio de carrera

Para profesionales que realizan la transición entre industrias:

I'm transitioning from finance to tech and need my CV (+27831112233, Jane Doe) tailored for this software developer role: Full Stack Developer position requiring JavaScript, React, and database skills.

Current CV:
# Jane Doe
## Background
- Financial Analyst at Bank Corp
- Recently completed coding bootcamp

Ejecutivo senior

Para puestos de nivel C y alta dirección:

I'm Michael Chen from the US (+1555123456) and need my executive CV customized for this CTO role: Chief Technology Officer requiring strategic leadership and team management skills.

My current CV:
# Michael Chen
## Executive Summary
Senior Technology Leader with 15+ years experience
## Experience
- VP Engineering at Tech Startup (2020-2024)

Niveles de servicio

• Nivel inicial (ID de producto: 1): Para recién graduados y profesionales al inicio de su carrera

• Nivel intermedio (ID de producto: 2): Para profesionales experimentados con 3-10 años de experiencia

• Nivel senior (ID de producto: 3): Para profesionales senior, gerentes y ejecutivos

Privacidad y términos

Al utilizar este servicio, aceptas los siguientes documentos de NextRole:

• Política de privacidad

• Términos de servicio

Desarrollo

Compilación

npm run build

Ejecución en desarrollo

npm run dev

Pruebas locales

npm start

Arquitectura

Este es un proxy ligero que reenvía las solicitudes MCP al servicio alojado de NextRole en https://api.nextrole.co.za/firstroleprod-mcp/mcp. El proxy:

• Traduce las solicitudes del protocolo MCP

• Las reenvía al servicio alojado

• Devuelve respuestas formateadas a los clientes MCP

• Maneja errores y problemas de conexión

Requisitos

• Node.js 18.0.0 o superior

• Conexión a Internet para acceder al servicio alojado de NextRole

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.

Soporte

Para problemas técnicos con este proxy, por favor abre un issue en GitHub. Para preguntas relacionadas con el servicio, contacta al soporte de NextRole a través de sus canales oficiales.