杠杆MCP服务器（本地）
本地MCP服务器将Claude Desktop连接到Lever ATS，使招聘人员能够通过自然语言命令管理他们的招聘工作流程，无需云托管或Cloudflare帐户。
这是原版的本地改编 lever mcp服务器 由sid dani撰写。原始版本在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-获取可用存档原因
🏗️ 运作原理
此服务器不是部署到云端，而是作为本地进程在您的计算机上运行。Claude Desktop会自动启动它，并通过stdio（同一台计算机上两个程序之间的直接管道）与它通信。您的Lever API钥匙以 .env 文件，永远不要离开它。
📋 先决条件
- 杠杆API键
- Node.js 18+和npm
- 克劳德桌面
🛠️ 安装
- 克隆存储库
git clone https://github.com/collinalldata/local-lever-mcp.git
cd local-lever-mcp- 安装依赖项
npm install- 添加您的Lever API密钥
复制示例env文件并填写密钥：
cp .env.example .env然后打开 .env 并替换 your_lever_api_key_here 使用实际的Lever API钥匙。
- 构建项目
npm run build这将TypeScript源代码编译成Node.js可以运行的JavaScript。
🔌 连接到克劳德桌面
- 打开克劳德桌面并转到 设置>开发人员>编辑配置
- 将以下内容添加到您的配置文件中（将路径替换为您克隆此仓库的位置）：
{
"mcpServers": {
"lever-recruiting": {
"command": "node",
"args": ["C:/path/to/local-lever-mcp/dist/local.js"]
}
}
}- 重新启动Claude Desktop——您应该看到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'"🧑💻 发展
# Rebuild after making changes to the source code
npm run build
# Run the local server directly (for testing outside Claude Desktop)
npm run start:local
# Type checking
npm run type-check
# Linting
npm run lint:fix
# Code formatting
npm run format📁 项目结构
├── src/
│ ├── local.ts # Local entry point (Claude Desktop uses this)
│ ├── server.ts # Original cloud entry point (not used locally)
│ ├── tools.ts # Registers all Lever tools
│ ├── additional-tools.ts # Extended tool implementations
│ ├── interview-tools.ts # Interview management tools
│ ├── lever/
│ │ └── client.ts # Lever API client
│ └── types/
│ └── lever.ts # TypeScript type definitions
├── dist/ # Compiled JavaScript (generated by npm run build)
├── .env # Your Lever API key (never committed to git)
├── .env.example # Template showing what .env should look like
└── wrangler.jsonc # Cloudflare config (only needed for cloud version)🔒 安全
- 您的Lever API密钥存储在本地
.env从git中排除的文件 - 服务器仅在Claude Desktop打开时运行，并不总是打开
- 除了直接发送到Lever API之外，不会将任何数据发送到任何位置
⚠️ 已知限制
- 没有机会文本搜索：利用API限制-名称搜索获取候选项，然后筛选客户端
- 文件下载：无法通过MCP下载文件--通过Lever web界面访问
- 有限的写入操作：只能添加备注和存档候选人
- 不创建应用程序：无法通过API创建新应用程序
- 无阶段变更：无法通过API在阶段之间移动候选人
📄 许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。