Recruiter Roles — Recruiter & Talent Acquisition Jobs MCP Server

Recruiter Roles MCP 服务

从任何支持 MCP 的 AI 客户端（Claude、Cursor、ChatGPT、VS Code 等）查询 Recruiter Roles 职位板。用自然语言提问，即可获取来自职位板的实时招聘和人才招聘职位、公司简介、行业、地点和市场统计数据。

只读。使用免费的 Recruiter Roles API 密钥进行身份验证。

• 托管（推荐）： https://recruiterroles.com/api/mcp（Streamable HTTP）
• 本地（此软件包）： npx recruiter-roles-mcp（stdio，适用于仅支持 stdio 的客户端）
• 获取免费 API 密钥： https://recruiterroles.com/api-access
• 文档： https://recruiterroles.com/mcp · REST API：https://recruiterroles.com/api-docs

工具

工具	描述
search_jobs	搜索并筛选实时职位（行业、地点、薪资、远程、发布时间、全文）。
get_job	查看单个职位的完整详情——描述、要求、福利、申请联系方式。
list_companies	浏览有活跃职位的招聘机构和雇主。
get_company	查看公司简介及其活跃职位。
list_sectors	查看所有招聘行业及其实时职位数量。
list_locations	查看有实时职位的国家、地区和城市。
market_stats	查看市场汇总概况——总量、职位发布速度和分类统计。

所有工具均标注为 readOnlyHint: true、destructiveHint: false、 openWorldHint: false，并提供 outputSchema。

连接

托管远程服务（推荐）

大多数客户端都可以直接连接托管的 Streamable HTTP 端点，并在 Authorization 标头中提供 API 密钥（对于无法设置标头的客户端，也可以将密钥作为 ?key= 查询参数传递）。

Cursor — ~/.cursor/mcp.json：

{
  "mcpServers": {
    "recruiter-roles": {
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

VS Code — .vscode/mcp.json：

{
  "servers": {
    "recruiter-roles": {
      "type": "http",
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

Claude / ChatGPT 自定义连接器 — 添加附带密钥的 URL：

https://recruiterroles.com/api/mcp?key=rr_live_YOUR_KEY

本地 stdio 服务（此 npm 软件包）

适用于仅支持 stdio 的客户端或本地开发。通过 RECRUITER_ROLES_API_KEY 环境变量设置 API 密钥：

{
  "mcpServers": {
    "recruiter-roles": {
      "command": "npx",
      "args": ["-y", "recruiter-roles-mcp"],
      "env": { "RECRUITER_ROLES_API_KEY": "rr_live_YOUR_KEY" }
    }
  }
}

直接运行：

RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY npx recruiter-roles-mcp

工作原理

这是基于公开的 Recruiter Roles v1 REST API 构建的轻量只读层。每个工具都会将你的 API 密钥转发到一个 GET /api/v1/* 端点，因此 MCP 用量与 REST API 共用相同的速率限制 （每个密钥每天 1,000 次请求）、缓存和请求日志记录。该服务不连接数据库，也不持有自己的密钥。

开发

npm install
npm run build
RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY node dist/index.js

可选：开发期间，可通过 RECRUITER_ROLES_BASE_URL 指向其他源站（默认值为 https://recruiterroles.com）。

反向链接政策

任何发布通过此服务获取的数据的页面或产品，都必须包含指向 Recruiter Roles 的可见且可爬取链接。如果删除反向链接，密钥可能会被暂停使用。

许可证

MIT — 参见 LICENSE。