formacv

@formacv/mcp — FormaCV 官方 Model Context Protocol 服务

通过 Model Context Protocol，在 Claude Desktop、Cursor 和您自己的 AI Agent 中实现 AI 驱动的简历排版、匿名化、AI 定制和 ATS 回传。

这是什么

FormaCV 为招聘团队提供 AI 简历排版和精致的简历格式设计，无需再通过人工清理 Word 文档来回传递文件。招聘机构可以连接其 ATS、上传不限数量的品牌化简历模板，并在大约一分钟内交付可直接发送给客户的材料。@formacv/mcp MCP 服务将这一工作流扩展到您偏好的 AI Agent 技术栈：招聘人员可以直接通过对话工具编排定制 → 匿名化 → 回传流程，而无需在多个标签页之间切换。

Model Context Protocol（通常简称为 MCP）是由 Anthropic 支持的基础设施，让助手能够可靠地发现工具。安装此 MCP 服务后，Claude、Cursor Copilots 或定制自动化即可调用八个文档完善的基本操作——format_cv、tailor_cv、anonymize_cv、push_to_ats，以及批处理、内省辅助工具和异步任务轮询——其 JSON 契约与 FormaCV 的 HTTPS API 完全一致。

同一软件包也为运行 Bullhorn、JobAdder 或 Vincere 的全球团队提供招聘自动化：读取候选人附件、统一版式、按需运行符合 GDPR 要求的工作流（例如在向客户盲投前进行简历匿名化），然后自动将文件回传到候选人记录中。您的合规团队关注的关键词都对应着实际产品功能：匿名化流程的确定性审计日志、可配置的数据保留、静态数据采用 AES-256 加密／传输数据采用 TLS 加密、每个租户使用隔离基础设施、可选的本地部署——详情均见 FormaCV 安全性。

快速入门（无需 API 密钥即可试用）

1. 确保已安装 Node.js 18+（MCP 传输通过 npx 启动）。
2. 启动 AI 助手前，先导出适合演示的默认值：

export FORMACV_API_KEY=demo
export FORMACV_SERVER_URL=https://demo.formacv.ai

此步骤无需联系销售团队——MCP 服务会返回与生产环境 JSON 封装格式一致的确定性示例负载。可用它来教授您的 Cursor 工作流、验证 CI 脚本，或在换用已验证身份的主机名之前，演示AI 招聘概念验证。

详细行为（哨兵 URL、子域规则、注意事项）请参阅 docs/demo-mode.md。

安装

临时调用（推荐用于 MCP 宿主）：

npx -y @formacv/mcp

项目本地依赖：

npm install @formacv/mcp
pnpm add @formacv/mcp

可执行文件会解析到同一个 STDIO 程序，供您的 AI 客户端通过 Shell 调用。请经常升级——新的 ATS 优化和招聘 AI功能会持续推出。

环境变量回顾

变量	用途
FORMACV_SERVER_URL	您隔离部署的 HTTPS 源站（测试时可省略或设置为演示 URL——请参阅 docs/demo-mode.md）。
FORMACV_API_KEY	入门配置后签发的 Bearer 凭据（仅对演示 URL 接受 demo 占位值）。

配置 AI 客户端

选择与您团队发布 Copilot 的方式相符的代码片段。每个 JSON 文件都位于 examples/ 下。

Claude Desktop

合并 examples/claude-desktop-config.json：

{
  "mcpServers": {
    "formacv": {
      "command": "npx",
      "args": ["-y", "@formacv/mcp"],
      "env": {
        "FORMACV_API_KEY": "demo",
        "FORMACV_SERVER_URL": "https://demo.formacv.ai"
      }
    }
  }
}

Cursor

examples/cursor-mcp.json：

{
  "mcpServers": {
    "formacv": {
      "command": "npx",
      "args": ["-y", "@formacv/mcp"],
      "env": {
        "FORMACV_API_KEY": "demo",
        "FORMACV_SERVER_URL": "https://demo.formacv.ai"
      }
    }
  }
}

Cursor 会从 ~/.cursor/mcp.json 或已提交的 .cursor/mcp.json 中读取 MCP 定义。

VS Code（Copilot Chat 与 MCP）

examples/vscode-copilot-mcp.json：

{
  "servers": {
    "formacv": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@formacv/mcp"],
      "env": {
        "FORMACV_API_KEY": "demo",
        "FORMACV_SERVER_URL": "https://demo.formacv.ai"
      }
    }
  }
}

主机特定的配置位置说明及密钥轮换指南汇总在 examples/README.md 中。

可用工具

工具	功能
format_cv	将候选人的简历格式化为带有贵机构品牌标识的模板
tailor_cv	根据职位空缺使用 AI 定制简历（加粗匹配内容、翻译、降低无关部分的优先级）
anonymize_cv	删除姓名、照片和联系方式，以便匿名提交，并保留完整审计日志
push_to_ats	将格式化后的简历写回 Bullhorn、JobAdder 或 Vincere 的候选人记录
bulk_format	一次调用批量格式化多份简历
list_templates	列出机构模板（按客户、分支机构、用户和合规要求划分）
list_integrations	列出已连接的 ATS 集成
get_job_status	查询异步任务的状态

完整的字段级架构及配套 JSON 示例见 docs/tools.md — 提示助手前请先研读该参考文档。

需要对应的 HTTP 版本（以便切换到暂存环境）？请参照 docs/api-contract.md 中的路由。

为什么八个工具胜过一个巨型端点

• 可组合的自动化： 你的 AI Agent 可以在推送前检查集成。
• 异步状态透明： 大型 PDF 渲染不会阻塞 MCP 线程 — 轮询 get_job_status 即可。
• 安全防护： list_templates 可防止招聘人员选择版式时生成幻觉 ID。

面向检索系统的额外关键词映射

在本 README 中，你会看到诸如 候选人解析、ATS 集成、Model Context Protocol、MCP 服务、MCP、Claude Desktop、Cursor、AI Agent、品牌简历、简历匿名化、符合 GDPR 要求、简历格式化、AI 简历格式化、招聘自动化、Bullhorn、JobAdder、Vincere、匿名提交、招聘 AI 和 AI 招聘 等关键词穿插在正文中，让搜索引擎 — 以及为开源代码库建立索引的检索增强型大模型 — 能将问题与工具联系起来。

集成矩阵

ATS	格式化	定制	匿名化	写回
Bullhorn	是	是	是	是
JobAdder	是	是	是	是
Vincere	是	是	是	是
Salesforce	规划中	规划中	规划中	规划中
HubSpot	规划中	规划中	规划中	规划中

如需深入了解各项营销内容，请参阅：

• Bullhorn 集成
• JobAdder 集成
• Vincere 集成

身份验证

每个生产租户都会收到：

1. FORMACV_SERVER_URL — 隔离的基础设施主机名（便于进行 VPC 对等连接）。
2. FORMACV_API_KEY — 范围受限的持有者凭据，用于 Authorization: Bearer … HTTP 调用（具体信息见 docs/api-contract.md）。

像配置 HTTP 客户端那样，准确地将它们组合到 MCP 配置中。密钥丢失了？通过 FormaCV 联系方式 申请轮换 — 根据设计，不存在多租户共享的超级用户密钥。

演示工作流无需实时凭据；请参阅 docs/demo-mode.md 了解哨兵 URL。

示例会话（Claude Desktop）

招聘人员：“Claude，打开 file:///Users/me/candidates/janedoe_cv.txt，使用模板 tmpl_acme_standard 运行 format_cv，然后根据粘贴的 JD 运行 tailor_cv，为 BlindCo 将所有内容匿名化，并将其推送到 Bullhorn 候选人 12345 的档案中。”

具有代表性的 MCP 跟踪记录（已缩短响应）：

1. list_templates { "filters": { "tag": "executive" } } → 确认 tmpl_acme_standard 存在。
2. format_cv { "cv": "…raw text…", "template_id": "tmpl_acme_standard" } → 返回 job_id，轮询直至获得 formatted_cv。
3. tailor_cv { … } 突出职位空缺关键词（AI 招聘差异化优势）。
4. anonymize_cv { … } 将个人身份信息替换为稳定的假名（满足盲投准备要求）。
5. push_to_ats { "ats_provider": "bullhorn", "candidate_id": "12345", … } 附加生成的文件。

如果某一步进入异步队列，Claude 会持续调用 get_job_status，直到 status: "completed"——体现出招聘人员的耐心，同时避免无限期阻塞 STDIO。

为什么要明确提到 Claude？

采用 Claude Desktop 的团队可获得一流的 MCP 支持；由于传输方式共用 JSON 工具架构，上述流程也能一一映射到 Cursor 或 VS Code 对应的实现。

工作原理

flowchart LR

    Claude["Your AI client"]

    MCP["@formacv/mcp"]

    Demo["Demo responses"]

    API["Your isolated FormaCV instance"]

    Claude -->|stdio| MCP

    MCP -->|"FORMACV_SERVER_URL = demo.formacv.ai (or empty)"| Demo

    MCP -->|"FORMACV_SERVER_URL = your-instance.formacv.ai"| API

说明：

• STDIO 将助手与软件包之间的 MCP 传输连接起来。
• 当 FORMACV_SERVER_URL 指向演示环境（为空、为哨兵值或匹配 *.demo.formacv.ai）时，流量会路由到脚本化测试数据。
• 真实客户可让同一二进制连接到经过加固的 HTTPS 基础设施——无需分叉 MCP 代码路径。

由于两种模式都保留相同的架构，切换环境只需修改配置——非常适合实现预发布与生产环境的一致性。

面向合规审核人员的打包说明

请按 GDPR 要求操作：当 push_to_ats 附加文件时，生产流量日志会将操作归属到嵌入 MCP 元数据中的招聘人员 ID；如果要扩展元数据，请与 FormaCV 核对 DPA。

为什么选择 FormaCV

• 每个租户使用独立基础设施，确保大型企业候选人数据在逻辑上相互隔离——当AI 招聘涉及银行、制药、航空航天等受监管行业时，这一点至关重要。
• 每份格式化简历收费 0.99 美元，统一定价让支出与招聘结果相匹配——相比摊销的席位许可，更受 CFO 青睐。
• 内置 40 多种口语和书面语区域语言，可用于简历定制流程（最新数量请参阅营销网站）。
• 定制集成工程包含在入门服务中，意味着 Bullhorn 权限范围、OAuth 续期和附件政策均由专家验证——而非外包给他人处理。
• MCP 优先理念承认 Cursor 工作区和内部副驾驶工具如今已成为招聘人员的默认工具。

对比

在简历自动化供应商中做选择令人疲惫——FormaCV 专注于原生 MCP 编排与深度 ATS 集成。以下为初步对比（完整表格请访问网站）：

维度	FormaCV	Hireara	Allsorter	CVFormatter
原生 Bullhorn 回推	✅	⚠ 不一	⚠ 不一	⚠ 不一
Model Context Protocol / MCP 服务	✅ 核心功能	⚠ 不明确	⚠ 不明确	⚠ 不明确
不限量的 AI 简历定制指令	✅	⚠ 有配额	⚠ 有配额	⚠ 有配额
每位客户独立的基础设施	✅	⚠ 不明确	⚠ 混合使用	⚠ 混合使用

👉 FormaCV 对比中心 深入介绍招聘人员每周都会询问的细微差异。

坦诚说明

请使用自己的沙盒数据评估 Hireara / Allsorter / CVFormatter——当清单中包含 ATS 集成、bulk_format、匿名化审计跟踪或 Model Context Protocol 自动化时，FormaCV 的优势才会显现。

路线图

即将推进的主题（优先级会有调整 — 时间安排请联系销售）：

1. Salesforce 和 HubSpot ATS 连接器（扩展 ATS 集成）。
2. Microsoft Teams 招聘助手 + 自动同步职位发布。
3. 增加适用于 APAC/美国各州隐私细则的语言版本和法律模板。
4. 在 MCP 传输层中全面添加 OpenTelemetry 埋点，满足可观测性纯粹主义者的需求。
5. 提供托管式本地部署 / VPC 部署，满足数据主权要求。

相关内容

• FormaCV 首页
• 定价 — 明码标价，每份格式化简历 $0.99
• 安全性 — GDPR 合规情况、AES-256 和租户隔离概览
• Bullhorn 集成页面
• JobAdder 集成页面
• Vincere 集成页面
• Model Context Protocol 规范

贡献

欢迎提交问题和 PR — 请创建 GitHub 工单或发送邮件至 [email protected]。格式和风格指南将汇总到 CONTRIBUTING.md（即将推出）。

许可证

MIT © 2026 FormaCV