Laddro Career

@laddro/career-mcp

面向 Laddro Career API 的 MCP 服务。让 AI Agent 能够使用简历定制、求职信生成、PDF 导出和模板浏览功能。

设置

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "laddro-career": {
      "command": "npx",
      "args": ["@laddro/career-mcp"],
      "env": {
        "LADDRO_API_KEY": "laddro_live_..."
      }
    }
  }
}

Claude Code

claude mcp add laddro-career -- npx @laddro/career-mcp

运行前设置环境变量 LADDRO_API_KEY。

远程 HTTP

使用托管的 Streamable HTTP 端点：

https://mcp.laddro.com/mcp

在 MCP 初始化请求中发送你的 Laddro API 密钥：

Authorization: Bearer laddro_live_...

或者：

x-api-key: laddro_live_...

可用工具

工具	描述
laddro.templates.list	浏览全部 22 个简历模板
laddro.templates.get	获取模板颜色和字体
laddro.fonts.list	所有可用字体系列
laddro.languages.list	全部 14 种支持的区域设置
laddro.resumes.list	用户的简历
laddro.resumes.get	简历元数据
laddro.resumes.render	使用新的模板设置重新渲染
laddro.resumes.tailor	使用 AI 为职位定制简历
laddro.resumes.export	导出为 PDF
laddro.coverLetters.list	用户的求职信
laddro.coverLetters.get	求职信元数据
laddro.coverLetters.create	手动创建
laddro.coverLetters.generate	根据简历和职位使用 AI 生成
laddro.coverLetters.render	使用模板设置渲染

连接器（OAuth）模式

该模式由 MCP_CONNECTOR_ENABLED 标志控制（默认关闭）。启用后，如果请求携带 Authorization: Bearer lad_at_*（Laddro OAuth 访问令牌），服务将运行 OAuth 连接器会话， 并将令牌转发到 laddro-backend（service.laddro.com），而非 career-api。它还提供 GET /.well-known/oauth-protected-resource（RFC 9728），并对未通过身份验证的 /mcp 调用返回 401 + WWW-Authenticate: Bearer resource_metadata=...，以便 OAuth 客户端发现授权服务器。关闭该标志时，行为保持不变（无发现路由，不强制返回 401，所有 18 个工具均通过 career-api 提供）。

连接器工具（仅限 OAuth 会话）：“内容由你撰写。Laddro 负责存储并渲染 PDF。”

工具	权限范围	描述
laddro.resume.schema	—	简历内容的 JSON Schema
laddro.resume.create	resumes:write	创建简历，返回 { resumeId }
laddro.resume.update	resumes:write	完整替换简历，返回 { resumeId, updatedAt }
laddro.coverLetter.schema	—	求职信内容的 JSON Schema

环境变量

变量	必需	描述
LADDRO_API_KEY	stdio 模式下必需；HTTP 模式下可选的备用值	你的 Laddro API 密钥
LADDRO_BASE_URL	否	覆盖 API URL（默认：https://api.laddro.com）
MCP_CONNECTOR_ENABLED	否	设为 true 可启用 OAuth 连接器模式（默认关闭）
LADDRO_BACKEND_URL	否	连接器工具的后端基础 URL（默认：https://service.laddro.com）
MCP_PUBLIC_URL	否	此服务用于 OAuth 元数据的公共 URL（否则根据转发标头推导）

开发

npm ci
npm test

npm test 会构建 TypeScript 包，并运行 MCP 契约测试，检查身份验证处理、工具元数据和处理程序路由。

发布

此包使用 Changesets 和 SemVer。

• 补丁版本：错误修复、文档、测试和内部加固。
• 次要版本：新增向后兼容的 MCP 工具或功能。
• 主要版本：工具名称、架构、身份验证或传输行为发生不兼容变更。

每个修改已发布包的 PR 都应包含一个 changeset：

npm run changeset

PR 合并到 main 后，GitHub Actions 会创建一个发布 PR，其中包含版本升级和变更日志。合并该发布 PR 后，包会发布到 npm，并创建 GitHub Release。Cloud Run 部署工作流也会在 main 上运行，因此托管的 MCP 服务会在发布 PR 合并后自动更新。

MCP 注册表

此服务器已作为 com.laddro/career 列入官方 MCP 注册表。server.json 是注册表清单；scripts/sync-version-metadata.mjs 会在每次发布时使其版本与 npm 包保持同步。

发布已实现自动化：.github/workflows/publish-registry.yml 会在 main 分支上的发布更改 server.json 时运行，并将新版本推送到注册表。身份验证基于 DNS——Ed25519 公钥存储在 laddro.com 的 TXT 记录中，对应的私钥（hex）则存储为仓库机密 MCP_PUBLISHER_ED25519_KEY。

如需手动发布（或补发）：

MCP_PUBLISHER_ED25519_KEY=<hex-private-key> ./scripts/publish-registry.sh

链接

• laddro.com
• API 参考
• 文档
• GitHub

许可证

MIT