杠杆MCP服务器
一个MCP服务器，将Lever ATS与Claude Desktop和其他MCP客户端集成在一起，使招聘人员能够通过自然语言命令管理他们的招聘工作流程。基于Cloudflare Workers构建，用于全球边缘部署。
🚀 特性
16招聘工具
搜索与发现
lever_advanced_search-具有多个过滤器的高级候选人搜索lever_find_by_company-查找来自特定公司的候选人lever_search_candidates-按姓名进行基本候选人搜索lever_quick_find_candidate-快速查找候选人（自动限制为100个结果）lever_find_candidates_for_role-查找特定职位的候选人lever_find_candidate_in_posting-在特定职位发布中搜索lever_find_internal_referrals_for_role-查找内部推荐
候选人管理
lever_get_candidate-获取详细的候选人信息lever_add_note-在候选人资料中添加备注lever_archive_candidate-将候选人存档并说明原因
应用程序和文件管理
lever_list_applications-列出候选人的所有申请lever_get_application-获取特定应用程序详细信息lever_list_files-列出候选人文件和简历
实用工具
lever_list_open_roles-列出所有空缺职位lever_get_stages-获得招聘渠道阶段lever_get_archive_reasons-获取可用存档原因
🏗️ 建筑
- Cloudflare员工：无服务器边缘部署
- TypeScript：杠杆API型全型安全
- MCP协议：标准模型上下文协议实现
- SSE端点：服务器发送事件以进行实时通信
- 速率限制：内置保护（符合Lever的10要求/秒限制）
📋 先决条件
- Cloudflare帐户
- 杠杆API键
- Node.js 18+和npm
- 牧马人CLI
🛠️ 安装
- 克隆存储库
git clone https://github.com/the-sid-dani/lever-mcp-server.git
cd lever-mcp-server- 安装依赖项
npm install- 配置Cloudflare
# Login to Cloudflare
npx wrangler login
# Set your Lever API key as a secret
npx wrangler secret put LEVER_API_KEY
# When prompted, paste your Lever API key- 部署到Cloudflare Workers
npm run deploy
# or use the deployment script
./deploy.sh您的服务器将部署到： https://lever-mcp-remote..workers.dev
🔌 连接到MCP客户端
克劳德桌面
- 安装MCP远程代理：
npm install -g mcp-remote- 打开克劳德桌面并转到 设置>开发人员>编辑配置
- 添加您的服务器配置：
{
"mcpServers": {
"lever-recruiting": {
"command": "npx",
"args": [
"mcp-remote",
"https://lever-mcp-remote..workers.dev/sse"
]
}
}
}- 重新启动Claude Desktop-您应该看到Lever工具可用！
Cloudflare AI游乐场
- 首选 游乐场.ai.cloudflare.com
- 输入您部署的MCP服务器URL：
https://lever-mcp-remote..workers.dev/sse - 直接从操场开始使用Lever工具！
💬 使用示例
连接到Claude Desktop后，您可以使用自然语言命令：
"Find all candidates from Google who applied for engineering roles"
"Show me candidates in the phone screen stage for the Senior Backend Engineer position"
"Add a note to John Doe's profile about our conversation today"
"List all open engineering positions"
"Archive this candidate with reason 'Position filled'"🧑💻 发展
地方发展
# Run local development server
npm run dev
# Type checking
npm run type-check
# Linting
npm run lint:fix
# Code formatting
npm run formatMCP检验员测试
# Install MCP Inspector
npm install -g @modelcontextprotocol/inspector
# Connect to your local or deployed server
npx @modelcontextprotocol/inspector
# Enter: http://localhost:8787/sse (local)
# Or: https://lever-mcp-remote..workers.dev/sse (deployed)📁 项目结构
├── src/
│ ├── index.ts # Main server entry point
│ ├── lever/
│ │ └── client.ts # Lever API client
│ ├── additional-tools.ts # Extended tool implementations
│ └── types/
│ └── lever.ts # TypeScript type definitions
├── wrangler.jsonc # Cloudflare Workers configuration
├── deploy.sh # Deployment helper script
└── CLAUDE.md # Claude Code guidelines🔒 安全
- API密钥存储为Cloudflare机密（从不在代码中）
- MCP端点不需要身份验证（如果生产需要，请添加身份验证）
- 利率限制防止API滥用
- 记录所有请求以进行监控
⚠️ 已知限制
- 没有机会文本搜索：利用API限制-名称搜索获取候选项，然后筛选客户端
- 文件下载：无法通过MCP下载文件-通过Lever web界面访问
- 有限的写入操作：只能添加备注和存档候选人
- 不创建应用程序：无法通过API创建新应用程序
- 无阶段变更：无法通过API在阶段之间移动候选人
🤝 贡献
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📄 许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
🙏 致谢
- 内置于 Cloudflare员工
- 使用 模型上下文协议
- 与集成 杠杆ATS API