@upcv/mcp-server

English

UPCV 的 MCP (Model Context Protocol) 服务。在 Claude Code、OpenClaw、Cursor、Windsurf 等 AI 助手中直接创建简历、浏览模板、搜索校招信息。

也可以访问 upcv.tech 网页端体验完整产品。

功能

• 简历管理 — 创建、查看、编辑、删除简历，导出 PDF
• 细粒度编辑 — 逐字段更新基本信息、逐条添加/修改/删除经历，AI 不再需要管理完整 JSON
• 板块管理 — 创建自定义板块、调整板块顺序
• 样式配置 — 切换模板、调整主题色、字体、页边距
• 校招搜索 — 按城市、行业、专业、公司类型等多维度筛选
• 岗位搜索 — 浏览岗位详情、薪资、要求
• 智能推荐 — 发现最新发布或即将截止的校招
• 模板库 — 浏览和应用专业简历模板

安装

使用 npx 运行

env UPCV_API_KEY=your-api-key npx -y @upcv/mcp-server

全局安装

npm install -g @upcv/mcp-server

获取 API Key

1. 注册或登录 clawjob.upcv.tech
2. 登录后在首页即可获取 API Key

客户端配置

Claude Code / OpenClaw

claude mcp add upcv -- npx @upcv/mcp-server --api-key YOUR_API_KEY

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "upcv": {
      "command": "npx",
      "args": ["-y", "@upcv/mcp-server"],
      "env": {
        "UPCV_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

需要 Cursor 0.45.6+

1. 打开 Cursor 设置 > Features > MCP Servers
2. 点击 "+ Add New MCP Server"
3. 配置：
   • Name: upcv
   • Type: command
   • Command: env UPCV_API_KEY=your-api-key npx -y @upcv/mcp-server

Windows 用户：cmd /c "set UPCV_API_KEY=your-api-key && npx -y @upcv/mcp-server"

Windsurf

添加到 ./codeium/windsurf/model_config.json：

{
  "mcpServers": {
    "upcv": {
      "command": "npx",
      "args": ["-y", "@upcv/mcp-server"],
      "env": {
        "UPCV_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

配置项

| 方式 | 参数 | 说明 | |------|------|------| | 命令行 | --api-key | UPCV API Key（必填） | | 命令行 | --api-url | API 地址（默认 https://clawjob.upcv.tech） | | 环境变量 | UPCV_API_KEY | 等同 --api-key | | 环境变量 | UPCV_API_URL | 等同 --api-url |

命令行参数优先于环境变量。

可用工具

简历基础操作

| 工具 | 说明 | |------|------| | resume.list | 列出用户所有简历 | | resume.get | 获取简历完整详情 | | resume.create | 创建新简历，可指定模板 | | resume.update | 更新简历元信息（标题、slug、可见性） | | resume.delete | 删除简历 | | resume.print | 导出 PDF 并返回下载链接 | | template.list | 获取可用模板列表 |

简历内容编辑（细粒度）

这些工具内部自动处理 获取 → 合并 → 提交，AI 只需传要修改的部分：

| 工具 | 说明 | |------|------| | resume.updateBasics | 更新基本信息（姓名、邮箱、电话等），只传要改的字段 | | resume.updateSection | 替换整个板块内容，或更新个人总结 | | resume.updateSectionItem | 更新或新增单个条目（传 itemId = 更新，不传 = 新增） | | resume.deleteSectionItem | 删除单个条目 | | resume.updateMetadata | 更新样式配置（模板、主题色、字体等） |

板块管理

| 工具 | 说明 | |------|------| | section.create | 创建自定义板块并添加到布局 | | section.delete | 删除自定义板块并从布局移除 | | resume.reorderLayout | 调整板块显示顺序 |

校招搜索

| 工具 | 说明 | |------|------| | campus.searchRecruitments | 搜索校招项目，支持多维度筛选 | | campus.getRecruitment | 获取校招详情及关联岗位 | | campus.recommend | 获取最新/即将截止的校招推荐 | | campus.searchJobs | 搜索具体岗位 | | campus.getJob | 获取岗位详情 |

使用示例

创建简历并填充内容：

你：帮我创建一份前端工程师简历
AI：[调用 resume.create → resume.updateBasics → resume.updateSection × N]
    简历已创建并填充了基本信息和工作经历。

修改某条工作经历：

你：把第一段工作经历的职位改成"高级前端工程师"
AI：[调用 resume.get → resume.updateSectionItem]
    已更新，职位已改为"高级前端工程师"。

搜索校招 + 优化简历：

你：帮我找字节跳动的校招，然后针对性地改简历
AI：[调用 campus.searchRecruitments → campus.getJob
     → resume.get → resume.updateSectionItem × N]
    已根据岗位要求优化了你的简历。

导出 PDF：

你：导出简历为 PDF
AI：[调用 resume.print]
    PDF 已生成，下载链接：https://...

错误处理

| 状态码 | 说明 | |--------|------| | 400 | 数据格式校验失败 — 返回具体的字段级错误详情 | | 401 | API Token 无效或已过期 — 请在 clawjob.upcv.tech 重新获取 | | 402 | 积分不足 — 请访问 clawjob.upcv.tech 获取更多积分 | | 403 | 权限不足 — 请检查账户权限 | | 404 | 资源不存在 | | 429 | 请求过于频繁 — 请稍后再试 |

本地开发

git clone https://github.com/HireTechUpUp/upcv-mcp-server.git
cd upcv-mcp-server
npm install
npm run build

使用 MCP Inspector 调试：

npx @modelcontextprotocol/inspector node dist/index.js --api-key YOUR_API_KEY

相关项目

• UPCV — AI 简历平台

License

MIT