MCP Server for NovaCV

模型上下文协议(MCP)服务器，用于接入 NovaCV 简历服务 API。

功能特点

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

获取 API 密钥

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

1. 访问 NovaCV API 官网

2. 注册或登录您的账户

3. 在控制面板中找到 "API Keys" 或 "开发者" 部分

4. 创建新的 API 密钥并复制它

5. 在使用 MCP 服务时配置此密钥

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

安装

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

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

快速开始

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

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

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

方法二：使用 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 客户端配置

Cursor 配置

在 Cursor 配置文件中添加:

{
  "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 或 Model Context Protocol 设置区域

3. 添加新服务，配置如下:

如果支持 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