NovaCV

Un servidor MCP para acceder a la API del servicio de currículums NovaCV.

GitHub
3
Prueba este MCPPatrocinado

Documentación

Servidor MCP para NovaCV

Servidor de Protocolo de Contexto de Modelo (MCP) para acceder a la API del servicio de currículums NovaCV.

Características

  • Generar currículums en PDF
  • Obtener la lista de plantillas de currículum disponibles
  • Convertir texto de currículum al formato JSON Resume
  • Analizar el contenido del texto del currículum

Obtener una clave de API

Antes de usar este servicio, necesita obtener una clave de API de NovaCV:

  1. Visite el sitio web oficial de la API de NovaCV
  2. Regístrese o inicie sesión en su cuenta
  3. En el panel de control, busque la sección "API Keys" o "Desarrolladores"
  4. Cree una nueva clave de API y cópiela
  5. Configure esta clave al usar el servicio MCP

Guarde su clave de API de forma segura y no la comparta públicamente.

Instalación

# 全局安装
npm install -g mcp-server-novacv

# 或使用 npx 运行
npx mcp-server-novacv --api_key=your_api_key

Inicio rápido

Método 1: Ejecución directa (recomendado)

La forma más sencilla es usar nuestro comando de inicio rápido:

# 一键构建并启动服务
npm run run

Método 2: Usar MCP Inspector para desarrollo y pruebas

Proporcionamos un comando combinado para compilar e iniciar Inspector con un solo paso:

# 一键构建并启动 Inspector
npm run debug

Uso

Opciones de línea de comandos

npx mcp-server-novacv [选项]

选项:
  --api_key=KEY        设置 NovaCV API 密钥
  --api_base_url=URL   设置 API 基础 URL
  --timeout=MS         设置 API 超时时间 (毫秒)
  --help, -h           显示帮助信息
  --version, -v        显示版本信息

Configuración de variables de entorno

Puede configurar la clave de API mediante variables de entorno:

NOVACV_API_KEY=your_api_key mcp-server-novacv

O cree un archivo .env:

NOVACV_API_KEY=your_api_key
NOVACV_API_BASE_URL=https://api.nova-cv.com

Consejo: La clave de API se puede obtener en el sitio web oficial de la API de NovaCV; consulte la sección "Obtener una clave de API" más arriba.

Configuración en el cliente MCP

Configuración en Cursor

Agregue lo siguiente en el archivo de configuración de Cursor:

{
  "mcpServers": {
    "novacv": {
      "command": "npx",
      "args": ["mcp-server-novacv"],
      "env": {
        "NOVACV_API_KEY": "your_api_key"
      }
    }
  }
}

Configuración en Cherry Studio

Configure el servicio MCP en Cherry Studio:

  1. Abra la configuración (haga clic en el icono de configuración en la esquina inferior izquierda o use Ctrl+,/Cmd+,)
  2. Busque el área de configuración de MCP o Model Context Protocol
  3. Agregue un nuevo servicio con la siguiente configuración:
    • Nombre: novacv
    • Comando: npx
    • Parámetros: mcp-server-novacv
    • Variables de entorno: agregue NOVACV_API_KEY y establezca su clave de API

Si se admite configuración JSON, agregue el siguiente contenido:

{
  "novacv": {
    "command": "npx",
    "args": ["mcp-server-novacv"],
    "env": {
      "NOVACV_API_KEY": "your_api_key"
    }
  }
}

Herramientas disponibles

El servidor MCP ofrece las siguientes herramientas:

  • generate_resume_from_text: Convierta texto de currículum en un PDF profesional con un solo clic, con soporte para múltiples plantillas. Solo necesita proporcionar el contenido del texto; el sistema realizará automáticamente la conversión de formato y generará un PDF profesional sin necesidad de manejar datos JSON manualmente
  • get_templates: Obtenga todas las plantillas de currículum disponibles; devuelve la lista de plantillas y su información detallada, incluidos ID, nombre, miniaturas, etc.
  • convert_resume_text: Convierta contenido de currículum en texto plano al formato estándar JSON Resume. El sistema identifica inteligentemente cada sección del currículum y lo estructura según el estándar internacional JSON Resume
  • analyze_resume_text: Realice un análisis profundo del texto del currículum y proporcione evaluación profesional y sugerencias de mejora. El sistema analiza la integridad, el uso de palabras clave, la coincidencia de habilidades y otros aspectos, y ofrece recomendaciones de optimización específicas

Ejemplos de uso

Obtener la lista de plantillas

En un cliente compatible con MCP, use el comando mcp_novacv_get_templates para obtener todas las plantillas de currículum disponibles.

Generar un currículum

Use el comando mcp_novacv_generate_resume_from_text y proporcione el contenido del texto del currículum y el nombre de la plantilla para generar un PDF.

Analizar texto de currículum

Use el comando mcp_novacv_analyze_resume_text para analizar contenido de currículum en texto plano.

Convertir texto de currículum a JSON Resume

Use el comando mcp_novacv_convert_resume_text para convertir texto de currículum al formato estructurado JSON Resume.

Desarrollo

# 安装依赖
npm install

# 开发模式（监视文件变化）
npm run dev

# 构建项目
npm run build

# 运行服务（构建并启动）
npm run run

# 使用 MCP Inspector 调试（构建并启动Inspector）
npm run debug

Solución de problemas

Si encuentra problemas durante la configuración:

  1. Confirme que el paquete se instaló correctamente: npx mcp-server-novacv --version
  2. Verifique que la clave de API esté configurada correctamente
  3. Revise los registros del cliente para ver si hay mensajes de error relevantes

Problemas con la clave de API

Si encuentra errores relacionados con la clave de API:

  • Asegúrese de haber obtenido una clave de API válida desde https://api.nova-cv.com
  • Verifique si la clave ha caducado o superó el límite de uso
  • Intente generar una nueva clave de API
  • Asegúrese de que la clave en la variable de entorno o el archivo de configuración no tenga espacios ni comillas adicionales

Licencia

MIT