内容
# @upcv/mcp-server
[English](./README.en.md)
[UPCV](https://upcv.tech) 的 [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) 服务。在 Claude Code、OpenClaw、Cursor、Windsurf 等 AI 助手中直接创建简历、浏览模板、搜索校招信息。
也可以访问 [upcv.tech](https://upcv.tech) 网页端体验完整产品。
## 功能
- 简历管理 — 创建、查看、编辑、删除简历，导出 PDF
- 细粒度编辑 — 逐字段更新基本信息、逐条添加/修改/删除经历，AI 不再需要管理完整 JSON
- 板块管理 — 创建自定义板块、调整板块顺序
- 样式配置 — 切换模板、调整主题色、字体、页边距
- 校招搜索 — 按城市、行业、专业、公司类型等多维度筛选
- 岗位搜索 — 浏览岗位详情、薪资、要求
- 智能推荐 — 发现最新发布或即将截止的校招
- 模板库 — 浏览和应用专业简历模板
## 安装
### 使用 npx 运行
```bash
env UPCV_API_KEY=your-api-key npx -y @upcv/mcp-server
```
### 全局安装
```bash
npm install -g @upcv/mcp-server
```
## 获取 API Key
1. 注册或登录 [clawjob.upcv.tech](https://clawjob.upcv.tech)
2. 登录后在首页即可获取 API Key
## 客户端配置
### Claude Code / OpenClaw
```bash
claude mcp add upcv -- npx @upcv/mcp-server --api-key YOUR_API_KEY
```
### Claude Desktop
添加到 `claude_desktop_config.json`：
```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`：
```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 | 请求过于频繁 — 请稍后再试 |
## 本地开发
```bash
git clone https://github.com/HireTechUpUp/upcv-mcp-server.git
cd upcv-mcp-server
npm install
npm run build
```
使用 [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) 调试：
```bash
npx @modelcontextprotocol/inspector node dist/index.js --api-key YOUR_API_KEY
```
## 相关项目
- [UPCV](https://upcv.tech) — AI 简历平台
## License
MIT
