跳转到主要内容
公共包源码与发包流程在 magic-resume-kit。本页中的 schema、模板、设计系统、图标、utils 和 MCP 源码路径及构建命令均相对此仓库;应用通过 npm 使用 @magic-resume-kit/*,不再包含这些工作区。 本页供打算修改 MCP 包本身或 fork 的贡献者参考。CLI 和服务器共用 config.ts,服务器通过 client.ts 调用 API。CLI 负责一次性的配置命令,MCP 服务器是 AI 工具拉起的进程。

MCP 包的目录是什么结构?

CLI 和服务器共用 config.ts;服务器通过 client.ts 调 API。CLI 负责一次性的配置命令;MCP 服务器是 AI 工具拉起的进程。

CLI 和 MCP 服务器有哪些入口?

  • CLI: package.json 里的 bin: { "magic-resume": "./dist/cli.js" }。子命令:config set、config print(PAT 打码显示)、config clear,以及 mcp(启动服务器)。
  • MCP 服务器: magic-resume mcp 启动 server.ts,注册工具,挂上 StdioServerTransport,常驻运行。

配置文件存在哪里、包含什么?

~/.magic-resume/mcp.json:
config.ts 在第一次使用时懒加载。Windows 上路径是 %USERPROFILE%\.magic-resume\mcp.json。
这个文件以明文存了 PAT。CLI 在 POSIX 系统上把权限设为 0600。如果你在 Windows 上贡献代码,不要放宽这个设置。

MCP 工具如何注册?

server.ts 用 @modelcontextprotocol/sdk 注册每个工具,提供:
  • 名字和描述
  • 用 Zod 派生的输入 Schema(让模型拿到带类型的参数提示)
  • 一个调用 resume-tools.ts 的 handler
工具总是返回结构化 JSON。错误以稳定错误码抛出 McpError,让 AI 工具能据此反应(如网络瞬断时重试,校验错时放弃)。

MCP 使用哪些 Core API 接口?

MCP 服务器是 Web 应用所用 NestJS Core API 的另一个客户端。相关接口: client.ts 自动附上 Authorization: Bearer <pat>。和 Web 应用不同,这里没有 Clerk —— PAT 是 Core API 单独认识的一套鉴权方式。

怎么构建和发布 MCP 包?

发布由 publishConfig.access = "public" 控制,pnpm 在打包时会把 workspace:* 重写为真实 semver,这样发出去的 package.json 里 @magic-resume-kit/resume-schema 和 @magic-resume-kit/resume-templates 都有合法版本号。

怎么添加新的 MCP 工具?

  1. 把 handler 加到 resume-tools.ts。保持函数纯粹,并基于 patch。
  2. 在 server.ts 里注册它,附上 Zod 输入 Schema 和简短描述。
  3. 在 test/ 里加 node --test 用例。
  4. 如果新工具读取或修改了新字段,更新 get_resume_editing_guide,让模型知道怎么用。