hirejack-mcp

@hirejack/mcp

Model Context Protocol 服务，向兼容 MCP 的客户端（Claude Desktop、Claude Code、Cursor、Cline 等）提供 HireJack 的技术岗位市场情报——技术岗位、公司、技能、薪资和招聘趋势。

快速开始

Claude Code：

claude mcp add hirejack -- npx -y @hirejack/mcp

Claude Desktop——编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "hirejack": {
      "command": "npx",
      "args": ["-y", "@hirejack/mcp"]
    }
  }
}

重启 Claude Desktop，然后尽管提问（请参阅示例提示）。

npm 包使用 stdio 传输——无需身份验证，以子进程形式在本地运行，五个公开工具开箱即用。

**claude.ai / Claude Desktop 连接器（全部 31 个工具）：**将 https://hirejack.com/api/mcp 添加为自定义连接器（Settings → Connectors → Add custom connector），按提示使用 HireJack 账户登录，即可使用完整的 Pro/Premium/Analyst 情报功能——服务端会根据你的订阅等级进行限制。

示例提示

求职搜索（公开，无需账户）：

• “查找支持签证、薪资 $200K 以上的远程高级后端岗位”
• “Stripe 目前在招聘什么岗位？按团队细分。”
• “展示纽约的资深级 ML 岗位，要求公开薪资范围”
• “目前有哪些公司在招聘 Rust 工程师？”

市场研究（公开，无需账户）：

• “本月哪些金融科技公司招聘扩张最快？”
• “当前技术领域有哪些热门技能？”
• “比较 Datadog 和 Grafana Labs 的技术栈”
• “高级数据工程师公开的薪资中位数是多少？”

职业情报（Pro/Premium，通过托管连接器）：

• “评估我与这个职位的匹配度，并告诉我还缺什么：hirejack.com/jobs/…”
• “我接下来应该学习哪项技能，才能解锁最多岗位？”
• “我的薪资与市场上的资深级平台工程师相比处于什么水平？”
• “针对这个 Anthropic 职位，改写我的简历要点”

Analyst（历史数据/细分分析，通过托管连接器）：

• “上一季度哪些公司的招聘增长超过 50%，且基数真实可靠？”
• “展示 Nvidia 过去 12 个月的招聘趋势”
• “哪些技能正从较低基数持续上升——只看早期信号”

斜杠命令（MCP 提示词）

支持 MCP 提示词的客户端（Claude Desktop、Cursor）会将这些提示词显示为斜杠命令。四个命令仅基于无需账户即可使用的工具构建，因此绝不会因身份验证错误而无法继续：

提示词	参数	功能
find_jobs	constraint（必填）	将自由格式的需求（“远程、$200K 以上、Rust”）映射为 search_jobs 筛选条件；结果过少时逐项放宽筛选条件，并完整获取最匹配的职位信息。
company_deep_dive	company（必填）	将公司名称解析为域名，获取招聘概况，然后展示目前开放的职位。
market_snapshot	focus（可选）	展示市场总体情况，也可按职位、技能或城市缩小范围。
salary_landscape	role_or_skill（必填）、location（可选）	仅使用公开薪资范围的职位信息，展示某个职位的实际薪资水平。

托管端点提供另一组个性化提示词（职业进展跟进、面试准备、按匹配度评分的职位搜索），因为这些功能需要经过身份验证的个人资料。

资源

该服务将 HireJack 的受控词汇表作为 MCP 资源公开：

URI	内容
hirejack://vocabulary/skills	HireJack 提取的所有技能，包含规范名称、ID 和类别
hirejack://vocabulary/roles	职位分类体系：titleId、title、family、IC/管理路线、典型技能

请先读取这些资源，再进行筛选。search_jobs.skill 会按子字符串匹配规范名称，因此 Kubernetes 可以返回职位，而 K8s 不会返回任何结果；update_preferences.desired_roles 则要求使用 roles 资源中的 titleId 值。

传输方式

传输方式	地址	可用工具
stdio（此软件包）	npx -y @hirejack/mcp	5 个公开工具（search_jobs、get_job、get_company_profile、search_companies、get_market_pulse）。Pro+/Analyst 工具会显示，但需要身份验证——请引导用户使用托管端点。
HTTP + OAuth 2.1（由 HireJack 托管）	https://hirejack.com/api/mcp	全部 31 个工具，包括 Pro+/Analyst 情报工具和与 HireJack 订阅关联的账户操作。实现位于 HireJack 的私有 Lambda 中；此 OSS 软件包是 stdio 部分。

工具

公开（无需身份验证）：

工具	用途
search_jobs	搜索实时技术职位：职位类别、资历级别、技能、地点、薪资、远程办公、签证、学历、经验
get_job	通过域名 + jobId 或 HireJack URL 获取一个职位：完整详情、薪资、技能、AI 摘要
get_company_profile	获取一家公司的完整招聘档案（技术栈、趋势、薪资、AI 简报）
search_companies	列出已跟踪的公司，按行业筛选
get_market_pulse	全市场统计数据：总量、热门技能、趋势技能、热门公司

Pro 层级（需要经过身份验证的 HireJack 用户，且订阅等级为 pro 或更高）：

工具	用途
match_job	评估用户与特定职位的匹配度（匹配百分比 + 5 维细分 + ATS 建议）
company_fit	评估用户与一家公司的匹配度（适配评分 + 技术栈/职位/资历级别细分）
recommendations	根据用户档案的综合匹配度对热门职位进行排名
salary_benchmark	对比实时市场中某一职位/资历级别的百分位数和职业阶梯基准
skill_gap	将用户技能与目标职位的市场要求进行比较；按排名列出缺失技能
market_position	0–100 的市场竞争力评分（技能需求、资历匹配、远程办公、技能广度）+ 匹配职位、薪资中位数、匹配度最高的公司
skill_impact	模拟学习每项缺失技能的效果：可解锁的职位、提升的匹配度、需要该技能的公司——按影响力排名
watchlist_intelligence	汇总所有关注公司的招聘信号：开放职位、周环比趋势百分比、热门技能、薪资中位数、迷你趋势图

Premium 层级（需要 premium）：

工具	用途
resume_rewrite	针对特定职位逐条改写简历要点
interview_prep	定向准备：关键主题、按类型分类的可能问题、公司调研事项

Analyst（专属 Analyst 层级——创始期定价为每月 $49；在职记者可免费使用，但需提供带链接的引用）：

工具	用途
get_company_history	单家公司时间序列：每月招聘快照及更长期的职位数量历史
get_skill_history	单项技能时间序列：每月的 companyCount 和 jobMentions，以及环比变化
get_market_history	整体市场时间序列：90 天每日数据或 24 个月每月数据
compare_companies	最多 5 家公司并排比较：当前情况及每月变化趋势
find_companies	多维度细分：行业 × 职能类别 × 技能 × 趋势 × 职位数量区间
find_breakout_companies	招聘增长极快的公司（百分比阈值 + 最小规模）
find_emerging_skills	从较低基数开始，在最近 3 个月度快照中持续攀升，且公司数量实际有所增加的技能——早期信号，而非小基数噪声（“我该在所有人之前学什么”工具）
find_emerging_roles	在可调时间窗口内（默认 21 天，每日汇总）获得更多公司采用的职位，以及分类器刚开始识别到的真正新职位名称——与 find_emerging_skills 配套的职位级工具

账户与个人资料（任何已认证的 HireJack 账户——读取和写入用户自己的数据）：

工具	用途
save_job	将职位保存到用户的已保存职位列表（或从中移除）
watch_company	关注（或取消关注）公司——为关注列表情报、提醒和每周摘要提供支持
track_application	跟踪申请流程：applied → phone_screen → interview → offer / rejected / withdrawn，并添加备注
list_saved_jobs	列出用户保存的职位（save_job 的读取配套工具），并标记后来已关闭的职位
list_applications	列出已跟踪的申请及其流程阶段（track_application 的读取配套工具）
list_watchlist	列出已关注的公司（watch_company 的读取配套工具）
get_profile	读取用户个人资料：技能、期望职位、等级，以及会对推荐和提醒进行硬筛选的匹配偏好（资历、城市、远程、仅限美国、最低薪资）
update_preferences	根据对话更新匹配偏好——最低薪资、是否要求列出薪资、远程 / 仅限美国、资历、城市——保存到个人资料，并立即重新筛选所有内容

与网站的切换端点不同，这些工具使用明确、幂等的操作（先检查状态），因此 Agent 重试“保存”操作时绝不会悄悄取消保存。写入工具（save_job、watch_company、track_application、update_preferences）标注为 readOnlyHint: false，以便 MCP 客户端适当地请求批准。

Pro+ 工具是对网站现有情报 Lambda 的轻量封装。等级限制在这些 Lambda 的服务端执行——MCP 服务只转发用户身份。如果用户没有所需等级，API 会返回 403，工具也会提供明确的升级提示。

从源代码构建

git clone https://github.com/TVLSS/hirejack-mcp
cd hirejack-mcp
npm install
npm run build       # tsc → dist/
node dist/index.js  # waits on stdin/stdout for JSON-RPC

发布

发布流程由 GitHub Actions（.github/workflows/release.yml）自动执行。 推送版本标签后，工作流会构建、发布到 npm，并更新 MCP Registry：

npm version patch          # bumps package.json + creates the vX.Y.Z tag
git push && git push --tags

工作流会验证标签与 package.json 中的版本一致，然后运行 npm publish （使用仓库密钥 NPM_TOKEN），并通过 GitHub OIDC 尽力更新 MCP Registry。请确保 server.json 中的 version 与 package.json 保持一致。

配置

环境变量	默认值	用途
HIREJACK_API_BASE	https://hirejack.com/api	如果你要自托管一个使用不同后端的分支，可覆盖此值
HIREJACK_SITE_BASE	https://hirejack.com	用于工具返回的 citation_url 字段

npm 软件包仅提供 stdio 传输。https://hirejack.com/api/mcp 上托管的 HTTP+OAuth 端点由 HireJack 单独运行，本仓库未实现该端点。

项目布局

src/
├── index.ts            # stdio entry point
├── registry.ts         # transport-agnostic tool registry
├── prompts.ts          # slash commands (public-tool-only by design)
├── resources.ts        # controlled vocabulary (skills, roles)
├── lib/
│   ├── api.ts          # HireJack REST client
│   ├── format.ts       # tool result helpers
│   └── proAuth.ts      # Pro+ auth check (returns "use hosted endpoint" in stdio)
└── tools/              # 29 files, 31 registered tools

许可证

MIT — 参见 LICENSE。

Support

• Issues / feature requests: https://github.com/TVLSS/hirejack-mcp/issues
• General feedback: https://hirejack.com/feedback.html
• Site / product: https://hirejack.com