AI导哈

ATS MCP服务器

连接AI代理与Homerun招聘系统的MCP服务器，支持AI辅助的候选人审查功能，包括浏览职位空缺、检查申请和添加评审笔记。

  • by softcery
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 softcery/homerun-ats-mcp

使用说明

Homerun ATS MCP服务器

连接AI代理的MCP服务器 全垒打 --申请人跟踪系统。启用人工智能辅助的候选人审核：浏览职位空缺、检查申请和留下审核笔记。

独立服务器。运行时不依赖于平台。用户可以像添加任何远程MCP服务器一样添加它。

工具

工具 说明
list_vacancies 列出带有可选状态过滤器和分页的职位空缺
get_vacancy 获取完整的职位空缺详细信息（描述、阶段、地点、部门）
list_applications 按职位空缺、阶段、雇佣状态、取消资格搜索/筛选申请
get_application 获取完整的申请详细信息（候选人简介、笔记、文件、问题答案）
add_note 在应用程序中添加评论注释

设置

获取Homerun API密钥

Homerun应用程序→ 集成→ API密钥。指定范围：

  • vacancies:read
  • job-applications:read
  • job-application-notes:read （适用于get_application中的注释）
  • job-application-notes:write （用于添加注释）

API访问需要HomerunPlus计划。

在本地运行

pnpm -F @softcery/mcp-homerun dev

开始 http://localhost:8080MCP终点为 /mcp.

环境变量

变量 默认值 描述
PORT 8080 服务器端口
HOST 0.0.0.0 绑定地址
SESSION_TIMEOUT_MS 1800000 会话到期（30分钟）
ALLOWED_HOSTS -- 允许使用逗号分隔的主机标头值（DNS重新绑定保护）

连接

从平台

管理用户界面→ 代理→ 集成→ 添加服务器：

  • 网址： https://<deployed-host>/mcp
  • API密钥： 您的Homerun API密钥

来自克劳德桌面

{
  "mcpServers": {
    "homerun": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <HOMERUN_API_KEY>"
      }
    }
  }
}

来自任何MCP客户端

发送一个 initialize 请求 POST /mcp 在 Authorization 头球服务器创建一个有状态的会话——后续请求使用 mcp-session-id 头球

身份验证模型

无服务器级身份验证。来自客户的Bearer令牌 Authorization 头直接用作Homerun API密钥。每个用户的密钥都有自己的速率限制（60请求/分钟）。

发展

pnpm -F @softcery/mcp-homerun test    # run tests
pnpm -F @softcery/mcp-homerun lint    # tsc + oxlint + knip
pnpm -F @softcery/mcp-homerun build   # production build

码头工人

docker build -f mcp-servers/homerun/Dockerfile -t mcp-homerun .
docker run -p 8080:8080 mcp-homerun

相关 MCP