AI导哈

候选人采购服务器

一个基于LinkedIn的候选人采购MCP服务器，用于搜索、管理和导出候选人信息。

  • by Anishshah2-gmail
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Anishshah2-gmail/candidate-sourcing-mcp

使用说明

候选采购MCP服务器

用于基于LinkedIn的候选人来源的MCP（模型上下文协议）服务器，旨在与Claude Desktop配合使用。

⚠️ 重要提示：提供商状态更新（2025年7月）

Proxycurl已关闭 由于领英的诉讼（于2025年7月4日宣布）。

目前推荐的方法：

  1. 领英人才解决方案API -联系您公司的LinkedIn管理员以获取API访问权限
  2. 替代供应商 -明亮数据，报废（参见 替代方案 部分）

当您有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合作伙伴关系访问。

  1. 获取LinkedIn API证书 来自您的LinkedIn人才解决方案管理员：

    • 客户端ID
    • 客户端密钥
    • 访问令牌
    • 刷新令牌（可选）

  2. 配置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"
      }
    }
  }
}

  3. 重新启动克劳德桌面

    完全退出并重新打开Claude Desktop以使更改生效。

用法

配置后，您可以在Claude Desktop中使用自然语言：

“在班加罗尔找到20名具有6-10年经验、强大的Java和微服务技能的高级后端工程师，最好来自金融科技公司”

克劳德将：

  1. 将您的请求转换为结构化搜索参数
  2. 调用MCP工具搜索LinkedIn个人资料
  3. 以招聘人员友好的形式介绍候选人
  4. 支持“排除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

添加新提供者

多提供商架构使添加新数据源变得容易：

  1. 在中创建新服务 src/services/ 实施 IDataProvider 接口
  2. 将提供程序类型添加到 src/types/provider.ts
  3. 更新 src/services/provider-factory.ts 包括新提供商
  4. 重建： 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

许可证

麻省理工学院

相关 MCP