@magic-resume/mcp 是一个 Model Context Protocol 服务器，把你的简历作为带类型、可 Patch 编辑的资源暴露给 AI 编程工具 —— Claude Code、Cursor、Windsurf，任何会说 MCP 的客户端都能用。
为什么要有它：把整份简历 JSON 粘到 AI prompt 里不靠谱。模型得猜 Schema、不知道哪些字段必填、也没办法验证自己的修改。MCP 给模型提供 结构化访问 —— Schema、样例数据、JSON Patch 校验、原子应用。
设计原则
- 基于 Patch，不做整片重写。 每次 mutation 都是 JSON Patch（RFC 6902），通过
fast-json-patch应用。模型改一行不用回吐整份简历。 - Schema 感知。 Patch 在落入存储 之前 已经被
@magic-resume/resume-schema校验过。非法 Patch 会被拒掉，并返回模型能读懂的结构化错误。 - 不依赖浏览器。 它是一个纯 Node ESM 进程，通过 HTTP 和 Core API 通信。没有 React、没有 IndexedDB、没有 Next.js 引用。
- PAT 鉴权，不是 Clerk。 用户在 Web 应用的 Settings 里签发个人访问令牌（PAT）；MCP 服务器拿这个 PAT 去 Core API 鉴权。Clerk 的 JWT 流程只在浏览器侧。
配置
工具参考
内部细节
什么时候适合用
MCP 服务器需要一个 Magic Resume 的 云端 账号，因为它走 Core API。自托管用户可以自己跑 Core API 来启用这一能力。