一个用于生成中文简历 PDF 并上传返回可访问链接的 MCP 工具与示例脚本。内置中文字体支持，适合中文内容排版。
## 特性
- 以 JSON 输入生成结构化简历 PDF
- 自动居中排版、模块分隔、链接可点击
- 内置中文字体（NotoSerifCJK）与粗体支持
- 可配置模块渲染顺序（教育、经历、项目、技能、荣誉）
- 上传到可访问的 URL（默认示例接口，可自行替换）
## 快速开始
### 环境要求
- Node.js ≥ 18
### 安装依赖
```bash
npm install
```
### 生成示例简历（本地）
```bash
node generate_resume.js
```
- 输出文件：`resume.pdf`
- 示例数据位于代码中，可作为结构参考（`generate_resume.js`）。
## 作为 MCP 工具使用
本项目内置一个 MCP 工具服务，采用 `stdio` 作为传输。你可以将其接入任意支持 MCP 的客户端。
```bash
{
"mcpServers": {
"resume": {
"command": "npx",
"args": [
"@tgapk/mcp-resume"
]
}
}
}
```
### 工具说明
- 工具名：`generate_resume`
- 输入：简历信息的 JSON（见下方示例）
- 输出：上传后的简历访问 URL（字符串）
#### 参数示例
```json
{
"fullName": "张三",
"email": "zhangsan@example.com",
"phone": "+86 138-0000-0000",
"location": "北京",
"website": "https://github.com/zhangsan",
"education": [
{
"institution": "清华大学",
"degree": "计算机科学（学士）",
"startDate": "2018-09",
"endDate": "2022-06",
"summary": "主修算法与前端技术"
}
],
"experience": [
{
"company": "某互联网公司",
"department": "前端团队",
"position": "前端开发工程师",
"startDate": "2022-07",
"endDate": "至今",
"highlights": [
"搭建组件库与主题系统",
"性能优化，LCP 降低 30%"
]
}
],
"projects": [
{
"name": "内容推荐系统",
"role": "核心开发",
"url": "https://example.com/project",
"summary": "基于用户行为的个性化推荐",
"highlights": ["使用 GraphQL","前后端契约测试"]
}
],
"skills": ["TypeScript","React","Node.js"],
"honors": ["前端性能优化奖"],
"order": ["experience","projects","skills","education","honors"]
}
```
## 自定义与扩展
- 字体：`fonts/` 目录内置中文字体，若缺失将回退到系统字体。
- 模块顺序：通过 `order` 指定模块渲染顺序（未指定的模块会按默认顺序补齐）。
- 链接处理：`website` 字段自动补全协议并在 PDF 中可点击。
- 样式：颜色、行高与间距等在代码中可调整。
## 文件结构
- `mcp.js`：MCP 服务入口与工具注册（`stdio` 传输）
- `generate_resume.js`：PDF 生成逻辑与示例数据调用
- `upload.js`：上传 PDF 并返回可访问 URL
- `fonts/`：中文字体文件（常规与粗体）
## 注意事项
- 上传接口默认指向：`https://xihuanwanyuanshen.icu/resume/upload/`，请根据实际情况替换为你的服务端地址。
- 隐私与合规：上传前请确认简历内容不包含个人敏感信息或严格保密内容。
- 生成的 PDF 默认保存为 `resume.pdf`，可在调用时传入自定义输出路径。
## 许可证
- License：ISC
