Homerun ATS MCP服务器
连接AI代理的MCP服务器 全垒打 --申请人跟踪系统。启用人工智能辅助的候选人审核:浏览职位空缺、检查申请和留下审核笔记。
独立服务器。运行时不依赖于平台。用户可以像添加任何远程MCP服务器一样添加它。
工具
| 工具 | 说明 |
|---|---|
list_vacancies | 列出带有可选状态过滤器和分页的职位空缺 |
get_vacancy | 获取完整的职位空缺详细信息(描述、阶段、地点、部门) |
list_applications | 按职位空缺、阶段、雇佣状态、取消资格搜索/筛选申请 |
get_application | 获取完整的申请详细信息(候选人简介、笔记、文件、问题答案) |
add_note | 在应用程序中添加评论注释 |
设置
获取Homerun API密钥
Homerun应用程序→ 集成→ API密钥。指定范围:
vacancies:readjob-applications:readjob-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:///mcp - API密钥: 您的Homerun API密钥
来自克劳德桌面
{
"mcpServers": {
"homerun": {
"url": "http://localhost:8080/mcp",
"headers": {
"Authorization": "Bearer "
}
}
}
}来自任何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