NovaCV

Um servidor MCP para acessar a API do serviço de currículos NovaCV.

GitHub
3
Experimente este MCPPatrocinado

Documentação

Servidor MCP para NovaCV

Servidor de Protocolo de Contexto de Modelo (MCP) para integração com a API do serviço de currículos NovaCV.

Recursos

  • Gerar currículos em PDF
  • Obter lista de modelos de currículo disponíveis
  • Converter texto de currículo para o formato JSON Resume
  • Analisar o conteúdo do texto do currículo

Obtendo uma chave de API

Antes de usar este serviço, você precisa obter uma chave de API da NovaCV:

  1. Acesse o site oficial da API NovaCV
  2. Registre-se ou faça login na sua conta
  3. No painel de controle, encontre a seção "API Keys" ou "Desenvolvedor"
  4. Crie uma nova chave de API e copie-a
  5. Configure esta chave ao usar o serviço MCP

Guarde sua chave de API com segurança e não a compartilhe publicamente.

Instalação

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

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

Início rápido

Método 1: Execução direta (recomendado)

A maneira mais simples é usar nosso comando de início rápido:

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

Método 2: Usando o MCP Inspector para desenvolvimento e testes

Fornecemos um comando combinado que compila e inicia o Inspector com um clique:

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

Como usar

Opções de linha de comando

npx mcp-server-novacv [选项]

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

Configuração de variáveis de ambiente

Você pode configurar a chave de API por meio de variáveis de ambiente:

NOVACV_API_KEY=your_api_key mcp-server-novacv

Ou crie um arquivo .env:

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

Dica: A chave de API pode ser obtida no site oficial da API NovaCV. Consulte a seção "Obtendo uma chave de API" acima.

Configuração no cliente MCP

Configuração no Cursor

Adicione no arquivo de configuração do Cursor:

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

Configuração no Cherry Studio

Configure o serviço MCP no Cherry Studio:

  1. Abra as configurações (clique no ícone de configurações no canto inferior esquerdo ou use Ctrl+,/Cmd+,)
  2. Encontre a área de configuração do MCP ou Model Context Protocol
  3. Adicione um novo serviço com a seguinte configuração:
    • Nome: novacv
    • Comando: npx
    • Parâmetros: mcp-server-novacv
    • Variáveis de ambiente: adicione NOVACV_API_KEY e defina sua chave de API

Se houver suporte a configuração JSON, adicione o seguinte conteúdo:

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

Ferramentas disponíveis

O servidor MCP oferece as seguintes ferramentas:

  • generate_resume_from_text: Converta texto de currículo em um currículo PDF elegante com um clique, com suporte a vários modelos. Basta fornecer o conteúdo do texto do currículo e o sistema formatará automaticamente e gerará um arquivo PDF profissional, sem necessidade de manipular dados JSON manualmente
  • get_templates: Obtenha todos os modelos de currículo disponíveis, retornando a lista de modelos e suas informações detalhadas, incluindo ID do modelo, nome, miniatura, etc.
  • convert_resume_text: Converta conteúdo de currículo em formato de texto simples para o formato padrão JSON Resume. O sistema identifica inteligentemente cada seção do currículo e o estrutura de acordo com o padrão internacional JSON Resume
  • analyze_resume_text: Faça uma análise aprofundada do texto do currículo, fornecendo avaliação profissional e sugestões de melhoria. O sistema analisa integridade, uso de palavras-chave, correspondência de habilidades e outros aspectos, e oferece sugestões de otimização direcionadas

Exemplos de uso

Obtendo a lista de modelos

Use o comando mcp_novacv_get_templates em um cliente compatível com MCP para obter todos os modelos de currículo disponíveis.

Gerando um currículo

Use o comando mcp_novacv_generate_resume_from_text e forneça o conteúdo do texto do currículo e o nome do modelo para gerar um currículo em PDF.

Analisando o texto do currículo

Use o comando mcp_novacv_analyze_resume_text para analisar o conteúdo do currículo em texto simples.

Convertendo texto de currículo para JSON Resume

Use o comando mcp_novacv_convert_resume_text para converter o texto do currículo para o formato estruturado JSON Resume.

Desenvolvimento

# 安装依赖
npm install

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

# 构建项目
npm run build

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

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

Solução de problemas

Se você encontrar problemas durante a configuração:

  1. Confirme se o pacote foi instalado com sucesso: npx mcp-server-novacv --version
  2. Verifique se a chave de API foi configurada corretamente
  3. Verifique os logs do cliente para mensagens de erro relacionadas

Problemas com a chave de API

Se você encontrar erros relacionados à chave de API:

  • Certifique-se de ter obtido uma chave de API válida em https://api.nova-cv.com
  • Verifique se a chave expirou ou excedeu os limites de uso
  • Tente gerar uma nova chave de API
  • Certifique-se de que a chave nas variáveis de ambiente ou no arquivo de configuração não tenha espaços extras ou aspas

Licença

MIT