Lever MCP Server (The Sid Dani)

杠杆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

🛠️ 安装

1. 克隆存储库

   git clone https://github.com/the-sid-dani/lever-mcp-server.git
   cd lever-mcp-server

1. 安装依赖项

   npm install

1. 配置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

1. 部署到Cloudflare Workers

   npm run deploy
   # or use the deployment script
   ./deploy.sh

您的服务器将部署到： https://lever-mcp-remote..workers.dev

🔌 连接到MCP客户端

克劳德桌面

1. 安装MCP远程代理：

   npm install -g mcp-remote

1. 打开克劳德桌面并转到 设置>开发人员>编辑配置

1. 添加您的服务器配置：

   {
     "mcpServers": {
       "lever-recruiting": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://lever-mcp-remote..workers.dev/sse"
         ]
       }
     }
   }

1. 重新启动Claude Desktop-您应该看到Lever工具可用！

Cloudflare AI游乐场

1. 首选 游乐场.ai.cloudflare.com
2. 输入您部署的MCP服务器URL： https://lever-mcp-remote..workers.dev/sse
3. 直接从操场开始使用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 format

MCP检验员测试

# 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滥用
• 记录所有请求以进行监控

⚠️ 已知限制

1. 没有机会文本搜索：利用API限制-名称搜索获取候选项，然后筛选客户端
2. 文件下载：无法通过MCP下载文件-通过Lever web界面访问
3. 有限的写入操作：只能添加备注和存档候选人
4. 不创建应用程序：无法通过API创建新应用程序
5. 无阶段变更：无法通过API在阶段之间移动候选人

🤝 贡献

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add some amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

🙏 致谢

• 内置于 Cloudflare员工
• 使用 模型上下文协议
• 与集成 杠杆ATS API