MCP 服务器用于 NovaCV 简历服务 API 接入

功能特点

• 生成简历 PDF 文件
• 获取可用简历模板列表
• 将简历文本转换为 JSON Resume 标准格式
• 分析简历文本内容并提供改进建议

获取 API 密钥指南

在使用 MCP 服务器之前，您需要获取 NovaCV 的 API 访问密钥：

1. 访问 NovaCV API 官网
2. 注册或登录您的账户
3. 在控制面板中找到 "API Keys" 或 "开发者工具" 部分
4. 创建新的 API 密钥并妥善保存
5. 按照文档说明将密钥配置到 MCP 服务器中

安装与运行

# 系统要求：Node.js (建议版本 12+)
# 在项目目录下执行以下命令：
npm install mcp-server-novacv

快速开始使用

方法一：直接运行服务器

npx mcp-server-novacv --version  # 检查安装是否成功
npx mcp-server-novacv --port=3000  # 以指定端口启动服务

方法二：使用 MCP Inspector 调试工具

npx mcp-server-novacv debug  # 启动调试模式

使用说明

• 命令行参数：

  • --port 指定服务器运行端口，默认为 3000。
  • --env 设置运行环境（development、production 等）。

• 配置文件： 创建或修改 config.json 文件，添加如下内容：

{
  "api_key": "your_api_key_here",
  "template_dir": "./templates",
  "default_template": "modern-blue"
}

可用功能

工具列表

1. 生成简历 PDF

   mcp_novacv_generate_resume_from_text --text="你的简历内容" --template="模板名称"
   

2. 获取模板列表

   mcp_novacv_get_templates
   

3. 转换为 JSON Resume 格式

   mcp_novacv_convert_resume_text --input_file="简历文本路径" --output_file="输出路径"
   

4. 分析简历内容

   mcp_novacv_analyze_resume_text --file="简历文件路径"
   

开发与维护

项目开发流程

1. 克隆代码库：

   git clone https://github.com/your-repo/mcp-server-novacv.git
   cd mcp-server-novacv
   

2. 安装依赖包：

   npm install
   

3. 开发模式启动（实时监控文件变化）：

   npm run dev
   

4. 构建生产版本：

   npm run build
   

5. 启动构建后的服务：

   npm start
   

调试与测试

• 使用 MCP Inspector 工具进行调试：

  npm run debug
  

  这将启动一个交互式控制台，用于查看和分析 API 请求。

故障排除

遇到问题时，请按以下步骤排查：

1. 确认 MCP 服务器已成功安装：运行 npx mcp-server-novacv --version。
2. 检查配置文件中的 API 密钥是否正确无误。
3. 查看控制台或日志文件中是否有错误提示信息。

常见问题

• API 密钥问题：

  • 确保密钥在 NovaCV 平台有效且未过期。
  • 检查配置文件中的密钥是否与平台设置的一致。

• 网络连接问题：

  • 确认服务器和客户端之间的网络通信正常。

许可证

本项目遵循 MIT 开源协议，允许自由使用、修改和分发。