用途
mcp-ashby 是一个 MCP（Model Context Protocol）服务器，用于访问公开的 Ashby 招聘看板。Ashby 是招聘软件，每家用它的公司都会附带一个公开职位看板，展示该公司的空缺职位，包括职位名称、部门与团队、雇佣类型、地点及是否远程、完整招聘广告，以及公司选择公开的薪酬信息（薪资范围、股权份额、佣金或奖金，各自带有计价周期）。Ashby 每家公司维护一个看板，且不提供跨看板的索引。
该服务器将聊天客户端连接到这些看板。用户指定感兴趣的公司，服务器将每个公司名称解析为对应看板的标识，搜索其职位，按部门、团队、地点、国家、雇佣类型、远程、发布时间或薪酬过滤，读取单个职位的完整内容，列出每个看板实际使用的词汇，并将多个职位的薪酬并排比较。无需 API 密钥，无需账户。
主要能力
- 解析公司看板：将公司名称转换为 Ashby 看板的标识。每个名称会尝试四种形式，因此“未找到”并不证明该公司不在 Ashby 上。
- 搜索职位：搜索指定公司的职位，返回职位标题、部门、团队、雇佣类型、地点、国家、次要地点数量、工作场所类型、是否远程、发布时间（含 Ashby 发布的时区偏移）、薪酬摘要、职位页面 URL 和申请 URL。搜索行不包含广告正文。返回结果区分看板上的职位总数、匹配条件的职位数以及本次返回的职位数。
- 读取完整职位：读取单个职位的完整招聘广告，包含描述、地点和公司公开的薪酬组成部分。html 为公司原始标记，未经改写。
- 列出过滤值：列出某个看板实际使用的词汇及每个值对应的职位数量，并指出仅大小写或空格不同的拼写变体。
- 比较薪酬：将多个职位的某一薪酬组成部分并排比较。一次只比较一个组成部分（股权与薪资不可相加）。以不同周期计价的职位会单独列出，不做换算。返回结果会标明涉及的货币，并列出公司未公开薪酬的职位（未公开不等于零）。
使用方式
一键安装
适用于 Claude Desktop、Cursor 及任何使用标准配置格式的客户端。需要 Node 24 或更高版本，无需设置环境变量。
安装命令中 -i 保持标准输入打开（协议传输通道），省略 -t 因为 TTY 会重写流。容器需要到 api.ashbyhq.com 的出站 HTTPS，不需要其他：无卷、无端口、无凭据。
不使用 npm 的捆绑包
从最新发布下载 mcp-ashby-2.0.1.mcpb 并打开。支持 MCP 捆绑包的客户端会自动安装，无需 npm，也无需编辑配置文件。捆绑包自带依赖，安装时不下载任何内容。
可以提出的问题示例
- “Ramp 在 Ashby 上招聘吗？”
- “帮我找 Ramp 和 Linear 的远程设计职位。”
- “把那个职位完整读给我听。”
- “那个看板把职位归在哪些部门下？”
- “把那些工程职位的薪资并排比较。”
每个问题都从公司开始，因为 Ashby 不提供跨看板搜索。search_jobs 会自行解析给出的名称，无需预先准备。每个看板有自己的部门和团队，因此用其他看板的词汇写的过滤器会筛不出任何结果。list_filter_values 会发布某个看板实际使用的词汇。
作为库使用
读取 Ashby 的层可单独发布，带有自己的节奏控制、缓存和错误处理，不附带协议。ClientOptions 接受 minIntervalMs、timeoutMs、cacheTtlMs 和 fetchImpl。低于已发布下限的间隔会被忽略，因此下限在此同样生效。
适用场景
- 求职者或招聘人员查询特定公司在 Ashby 上的公开职位。
- 按部门、团队、地点、国家、雇佣类型、远程、发布时间或薪酬筛选职位。
- 阅读单个职位的完整招聘广告。
- 了解某个看板实际使用的部门、团队等词汇，以便正确过滤。
- 将多个职位的同一薪酬组成部分并排比较。
限制
- 每个问题必须从公司开始，Ashby 不提供跨看板搜索。
- 每个看板有自己的部门和团队词汇，跨看板使用过滤器可能筛不出结果。
- 搜索行不包含广告正文，需用
get_job读取完整内容。 - 薪酬比较一次只能比较一个组成部分，不同周期的职位不做换算或年化。
- 公司未公开薪酬的职位返回为空，而非零。
- 请求逐个发出，间隔至少一秒，该下限不受客户端配置影响。Ashby 一次返回整个看板，可能达数兆字节，因此关于一家公司的一个问题消耗一次请求，服务器会短暂缓存答案。
- 服务器不读取任何环境变量，无需配置。
- 每个失败带有六种代码之一、一条消息，并在有帮助时给出本可接受的值。
- 该 MCP 服务器为非官方项目，与 Ashby 及其读取看板的公司无关联。
- 服务器不收集用户信息，不向作者发送任何内容，在本机运行，仅联系
api.ashbyhq.com，运行时将答案保存在内存中，不写入磁盘。 - 测试针对生成的固定数据运行，不发起网络请求。实时测试套件
npm run test:live每条路由发起一次请求，每晚针对服务本身运行。 - 许可证为 MIT。职位内容归发布它们的公司所有。
隐私与归属
服务器不收集任何用户信息，不向作者发送任何内容。在本机运行，仅联系 api.ashbyhq.com，运行时将答案保存在内存中，不写入磁盘。PRIVACY.md 说明了请求携带的内容以及哪些设置会改变这些内容。每个职位带有其 Ashby 页面地址和申请 URL。展示职位时应注明公司并链接该页面。
