> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magic-resume.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 服务器总览

> @magic-resume/mcp 是原生的 Model Context Protocol 服务器，把你的简历作为带类型、可 Patch 编辑的资源暴露给 AI 编程工具。

`@magic-resume/mcp` 是一个 [Model Context Protocol](https://modelcontextprotocol.io) 服务器，把你的简历作为带类型、可 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 流程只在浏览器侧。

<CardGroup>
  <Card title="配置" href="/zh/mcp/setup" />

  <Card title="工具参考" href="/zh/mcp/tools" />

  <Card title="内部细节" href="/zh/mcp/internals" />
</CardGroup>

## 什么时候适合用

| 任务                             | 用 MCP？                                                  |
| ------------------------------ | ------------------------------------------------------- |
| 在 Claude Code 里"按这份 JD 调整我的简历" | ✅ —— 模型读 Schema、起草 patch、预览、应用                          |
| 在多份简历里批量替换公司名                  | ✅ —— `list_resumes` → 逐个 `update_resume_content`        |
| 基于简历数据搭一个自己的 dashboard         | ❌ —— 直接用 PAT 调 Core API 就行，不需要 MCP                      |
| 从零生成一份全新简历                     | ⚠️ —— 可以，但建议用 `defaultResume` + 一连串小 patch，而不是一个大 patch |

<Info>
  MCP 服务器需要一个 Magic Resume 的 **云端** 账号，因为它走 Core API。自托管用户可以自己跑 Core API 来启用这一能力。
</Info>