MCP Server for NovaCV

模型上下文协议（MCP）服务器，用于访问NovaCV简历服务API。

功能

• 生成简历PDF
• 获取可用简历模板列表
• 将简历文本转换为JSON Resume格式
• 分析简历文本内容

获取API密钥

在使用此服务之前，您需要获取NovaCV API密钥：

1. 访问NovaCV API官网
2. 注册或登录您的账户
3. 在控制面板中找到“API密钥”或“开发者”部分
4. 创建一个新的API密钥并复制它
5. 在使用MCP服务时配置此密钥

请妥善保管您的API密钥，不要在公共场合分享。

安装

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

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

快速开始

方法1：直接运行（推荐）

最简单的方法是使用我们提供的快速启动命令：

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

方法2：使用MCP Inspector进行开发和测试

我们提供了一个组合命令，允许一键构建并启动Inspector：

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

使用说明

命令行选项

npx mcp-server-novacv [选项]

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

环境变量配置

可以通过环境变量来配置API密钥：

NOVACV_API_KEY=your_api_key mcp-server-novacv

或者创建一个.env文件：

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

提示API密钥可以从NovaCV API官网获得，请参阅上面的“获取API密钥”部分。

在MCP客户端上配置

鼠标配置

添加：

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

Cherry Studio配置

在Cherry Studio中设置MCP服务：

1. 打开设置（点击左下角的设置图标或使用）Ctrl+,/Cmd+,）
2. 查找MCP或模型上下文协议设置区域
3. 添加一个具有以下配置的新服务：
   • 名称：novacv
   • 命令：npx
   • 参数：mcp-server-novacv
   • 环境变量：添加NOVACV_API_KEY并设置您的API密钥

如果支持JSON配置，则添加以下内容：

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

可用工具

MCP服务器提供了以下工具：

• generate_resume_from_text通过单击将简历文本转换成美观的PDF简历，支持多种模板。只需提供简历文本内容，系统将自动转换格式并生成专业PDF文件，无需手动处理JSON数据
• get_templates检索所有可用的简历模板，返回模板及其详细信息的列表，包括模板ID、名称、缩略图等
• convert_resume_text将纯文本格式的简历内容转换为标准的JSON Resume格式。系统将智能识别简历的各个部分，并根据国际公认的JSON Resume标准进行结构化
• analyze_resume_text深入分析简历文本，提供专业的评估和改进建议。系统将分析简历的完整性、关键词使用情况、技能匹配度，并提供针对性的优化建议

使用示例

获取模板列表

在支持MCP的客户端中使用mcp_novacv_get_templates命令以检索所有可用的简历模板。

生成简历

使用mcp_novacv_generate_resume_from_text命令并提供简历文本内容和模板名称以生成PDF简历。

分析简历文本

使用mcp_novacv_analyze_resume_text命令分析纯文本简历内容。

将简历文本转换为JSON Resume

使用mcp_novacv_convert_resume_text命令将简历文本转换为结构化的JSON Resume格式。

开发

# 安装依赖
npm install

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

# 构建项目
npm run build

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

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

故障排除

如果您在设置过程中遇到任何问题：

1. 确认包已成功安装：npx mcp-server-novacv --version
2. 检查API密钥是否设置正确
3. 检查客户端日志中是否有相关错误消息

API密钥问题

如果遇到与API密钥相关的错误：

• 确保您已经从https://api.nova-cv.com获得了有效的API密钥
• 检查密钥是否已过期或超出使用限制
• 尝试重新生成新的API密钥
• 确保环境变量或配置文件中的密钥没有多余的空格或引号

许可证

MIT