候选采购MCP服务器
用于基于LinkedIn的候选人来源的MCP（模型上下文协议）服务器，旨在与Claude Desktop配合使用。
⚠️ 重要提示：提供商状态更新（2025年7月）
Proxycurl已关闭 由于领英的诉讼（于2025年7月4日宣布）。
目前推荐的方法：
- 领英人才解决方案API -联系您公司的LinkedIn管理员以获取API访问权限
- 替代供应商 -明亮数据，报废（参见 替代方案 部分）
当您有API访问权限时，多提供商架构允许轻松切换。
______________________________________________________________________
特性
- 多提供商架构 -轻松在数据提供商之间切换
- LinkedIn搜索 -使用筛选器（职位、技能、地点、经验、资历、公司、行业）搜索候选人
- 详细简介 -获取候选人的完整个人资料信息
- 书签 -保存带有注释和标签的候选人以供以后查看
- 出口 -将候选者导出为JSON或CSV格式
数据提供程序
| 提供者 | 状态 | 设置 | 备注 |
|---|---|---|---|
| 领英人才API | ✅ 推荐 | 需要合作伙伴关系 | 联系您的LinkedIn人才解决方案管理员 |
| Proxycurl | ❌ 停产 | N/A | 2025年7月停止运营 |
| 亮数据 | 🔄 可添加 | API密钥 | 可选选项 |
MCP工具（共9个）
| 工具 | 说明 |
|---|---|
linkedin_search_candidates | 使用结构化筛选器搜索候选人 |
linkedin_get_candidate_details | 获取候选人的完整个人资料详细信息 |
bookmark_candidate | 用注释/标签保存候选人 |
remove_bookmark | 从书签中删除 |
list_bookmarks | 列出所有已添加书签的候选人 |
update_bookmark | 更新注释/标签 |
get_bookmark_tags | 列出所有正在使用的标签 |
export_candidates | 导出为JSON/CSV |
get_provider_status | 检查提供程序配置状态 |
安装
# Clone the repository
git clone https://github.com/Anishshah2-gmail/candidate-sourcing-mcp.git
cd candidate-sourcing-mcp
# Install dependencies
npm install
# Build
npm run build配置
领英人才解决方案API（推荐）
注： 要求LinkedIn Recruiter System Connect API通过您公司的LinkedIn合作伙伴关系访问。
- 获取LinkedIn API证书 来自您的LinkedIn人才解决方案管理员：
- 客户端ID - 客户端密钥 - 访问令牌 - 刷新令牌（可选）
- 配置Claude桌面
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"candidate-sourcing": {
"command": "node",
"args": ["/path/to/candidate-sourcing-mcp/dist/index.js"],
"env": {
"DATA_PROVIDER": "linkedin",
"LINKEDIN_CLIENT_ID": "your_client_id",
"LINKEDIN_CLIENT_SECRET": "your_client_secret",
"LINKEDIN_ACCESS_TOKEN": "your_access_token",
"LINKEDIN_REFRESH_TOKEN": "your_refresh_token"
}
}
}
}- 重新启动克劳德桌面
完全退出并重新打开Claude Desktop以使更改生效。
用法
配置后，您可以在Claude Desktop中使用自然语言：
“在班加罗尔找到20名具有6-10年经验、强大的Java和微服务技能的高级后端工程师，最好来自金融科技公司”
克劳德将：
- 将您的请求转换为结构化搜索参数
- 调用MCP工具搜索LinkedIn个人资料
- 以招聘人员友好的形式介绍候选人
- 支持“排除FAANG”或“添加孟买”等改进
示例命令
"Search for Data Scientists in Mumbai with Python and ML experience"
"Show me details for candidate 3"
"Bookmark candidate 1 with tag 'shortlist'"
"Export all bookmarked candidates as CSV"
"What's my current provider status?"建筑
┌─────────────────────────────────────────────────────────────┐
│ Claude Desktop │
└─────────────────────────┬───────────────────────────────────┘
│ MCP Protocol
┌─────────────────────────▼───────────────────────────────────┐
│ Candidate Sourcing MCP Server │
├─────────────────────────────────────────────────────────────┤
│ Tools: search, details, bookmark, export, status │
├─────────────────────────────────────────────────────────────┤
│ Provider Factory │
│ │ │
│ ▼ │
│ ┌────────────┐ │
│ │ LinkedIn │ │
│ │ Talent API │ │
│ └────────────┘ │
│ (More providers can be added) │
└─────────────────────────────────────────────────────────────┘替代供应商
如果LinkedIn Talent API访问不可用，则存在以下替代方案（可添加实施方案）：
| 提供商 | 网站 | 备注 |
|---|---|---|
| 明亮的数据 | Brightdata.com | 最大的胜诉案件 |
| 报废 | scrapin.io | 实时，无需帐户 |
| 人员数据实验室 | peopledatalabs.com | 富集API |
⚠️ 法律说明： 第三方抓取服务可能面临来自LinkedIn的法律挑战。LinkedIn官方API是最安全的方法。
发展
# Watch mode for development
npm run dev
# Test with MCP Inspector
npm run inspector
# Build for production
npm run build添加新提供者
多提供商架构使添加新数据源变得容易：
- 在中创建新服务
src/services/实施IDataProvider接口 - 将提供程序类型添加到
src/types/provider.ts - 更新
src/services/provider-factory.ts包括新提供商 - 重建：
npm run build
故障排除
“提供程序未配置”错误：
- 检查您的API凭据是否已在Claude Desktop配置中设置
- 验证
DATA_PROVIDER环境变量设置正确 - 配置更改后重新启动Claude Desktop
“超出速率限制”：
- 请等待几分钟，然后再提出更多请求
- 考虑减少
page_size在搜索中
LinkedIn API错误：
- 验证您的访问令牌是否有效且未过期
- 请向您的LinkedIn管理员查询API访问状态
在新机器上设置
# 1. Install Node.js (if not installed)
# macOS with Homebrew:
brew install node
# 2. Clone the repository
git clone https://github.com/Anishshah2-gmail/candidate-sourcing-mcp.git
cd candidate-sourcing-mcp
# 3. Install and build
npm install
npm run build
# 4. Configure Claude Desktop (see Configuration section above)
# 5. Restart Claude Desktop许可证
麻省理工学院