🚀 MCP 服务器用于 NovaCV 简历服务 API 接入
MCP 服务器为 NovaCV 简历服务提供 API 接入功能，能助力用户生成简历 PDF、获取模板列表等，为简历处理带来便利。
🚀 快速开始
在使用 MCP 服务器之前，您需要获取 NovaCV 的 API 访问密钥：
- 访问 NovaCV API 官网
- 注册或登录您的账户
- 在控制面板中找到 "API Keys" 或 "开发者工具" 部分
- 创建新的 API 密钥并妥善保存
- 按照文档说明将密钥配置到 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"
}
💻 使用示例
基础用法
工具列表
- 生成简历 PDF
mcp_novacv_generate_resume_from_text --text="你的简历内容" --template="模板名称"
- 获取模板列表
mcp_novacv_get_templates
- 转换为 JSON Resume 格式
mcp_novacv_convert_resume_text --input_file="简历文本路径" --output_file="输出路径"
- 分析简历内容
mcp_novacv_analyze_resume_text --file="简历文件路径"
📚 详细文档
项目开发流程
- 克隆代码库：
git clone https://github.com/your-repo/mcp-server-novacv.git
cd mcp-server-novacv
- 安装依赖包：
npm install
- 开发模式启动（实时监控文件变化）：
npm run dev
- 构建生产版本：
npm run build
- 启动构建后的服务：
npm start
调试与测试
- 使用 MCP Inspector 工具进行调试：
npm run debug
这将启动一个交互式控制台，用于查看和分析 API 请求。
🔧 技术细节
遇到问题时，请按以下步骤排查：
- 确认 MCP 服务器已成功安装：运行
npx mcp-server-novacv --version。 - 检查配置文件中的 API 密钥是否正确无误。
- 查看控制台或日志文件中是否有错误提示信息。
常见问题
-
API 密钥问题：
- 确保密钥在 NovaCV 平台有效且未过期。
- 检查配置文件中的密钥是否与平台设置的一致。
-
网络连接问题：
- 确认服务器和客户端之间的网络通信正常。
📄 许可证
本项目遵循 MIT 开源协议，允许自由使用、修改和分发。