contratando-mcp

MCP 服务器，让 AI 代理（Hermes）控制 Contratando — 对平台的完整读写：职位、公司、候选人、申请、积分、订阅、佣金、用户和配置。

工作原理

此仓库无法访问数据库。它是一个轻量客户端：代理调用的每个 tool 都会通过 HTTPS 转发到 POST {MCP_BRIDGE_URL}/api/mcp，这是 Contratando 应用内部（已部署）的一条受保护路由。生产数据库有意保持私有模式——这个桥接器是在不暴露到互联网的情况下控制它的方式。

Hermes → contratando-mcp (stdio, local) → HTTPS + secreto → contratandord.com/api/mcp → Postgres (privada)

真正的逻辑（每个 tool 执行什么变更、验证、审计）位于 Contratando 仓库中（src/lib/mcp/registro.ts）。此仓库仅声明 46 个 tools（名称、描述、输入 schema），以便代理知道可以请求什么。

如果你要使用 scraper_mensajes_pendientes + vacantes_importar_lote（scraper → 草稿 → 审核流程），请参阅 PARSING.md 了解批次中每个 item 所期望的确切结构。

Related MCP server: HeadHunter API MCP Server

设置

npm install
cp .env.example .env

填写 .env：

• MCP_BRIDGE_URL — https://contratandord.com（或 http://localhost:3200 用于本地测试）。

• MCP_API_SECRET — 与 Contratando 的 .env 中的 MCP_API_SECRET 相同的值。如果不匹配，桥接器会以 401 拒绝所有请求。

npm start

连接到代理

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "contratando": {
      "command": "npx",
      "args": ["tsx", "C:\\ruta\\a\\contratando-mcp\\src\\server.ts"],
      "env": {
        "MCP_BRIDGE_URL": "https://contratandord.com",
        "MCP_API_SECRET": "..."
      }
    }
  }
}

Claude Code：

claude mcp add contratando -- npx tsx C:\ruta\a\contratando-mcp\src\server.ts

对于 Hermes 或其他 MCP 运行时：将其指向此目录中的 npm start（或 node --import tsx src/server.ts），并在环境中设置 MCP_BRIDGE_URL/MCP_API_SECRET。

它不做什么

• 不上传文件（logo、凭证、RNC 文档）。

• 不逐节编辑候选人的简历（经验/教育/语言逐项）——只处理申请和公司资料的基本内容。

• talento_ficha 从不返回电话/邮箱/身份证号——真正的人才搜索需要经过审计的解锁流程，此桥接器不复制该流程。

• 变更时不发送邮件，也不通知 Google——仅应用内通知。网站自行获取更改（配置缓存最长 30 秒，正常的 sitemap/爬取用于 SEO）。

安全

• 密钥在服务器端使用 timingSafeEqual 进行比较（不会因响应时间而泄露）。

• 桥接器上每个 IP 的速率限制为 30 次调用 / 5 分钟。

• 每次变更都会记录在 Contratando 的审计日志中，带有 datos.via: "mcp"，归属于服务器端 SEED_ADMIN_EMAIL 中配置的超级管理员。

• 如果密钥泄露，请在两侧轮换：Contratando 的 .env 中的 MCP_API_SECRET（重新部署）和此处。