@magic-resume-kit/*,不再包含这些工作区。
本页供打算修改 MCP 包本身或 fork 的贡献者参考。CLI 和服务器共用 config.ts,服务器通过 client.ts 调用 API。CLI 负责一次性的配置命令,MCP 服务器是 AI 工具拉起的进程。
MCP 包的目录是什么结构?
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。
MCP 工具如何注册?
server.ts 用 @modelcontextprotocol/sdk 注册每个工具,提供:
- 名字和描述
- 用 Zod 派生的输入 Schema(让模型拿到带类型的参数提示)
- 一个调用
resume-tools.ts的 handler
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 工具?
- 把 handler 加到
resume-tools.ts。保持函数纯粹,并基于 patch。 - 在
server.ts里注册它,附上 Zod 输入 Schema 和简短描述。 - 在
test/里加node --test用例。 - 如果新工具读取或修改了新字段,更新
get_resume_editing_guide,让模型知道怎么用。
