mcp-server-novacv

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

MCP 服务器为 NovaCV 简历服务提供 API 接入功能，能助力用户生成简历 PDF、获取模板列表等，为简历处理带来便利。

🚀 快速开始

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

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

✨ 主要特性

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

📦 安装指南

# 系统要求：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 开源协议，允许自由使用、修改和分发。