People Finder MCP

人员查找MCP（或：人员定位MCP，具体翻译可能根据上下文调整）

一款独立的模型上下文协议（MCP）工具，可通过LinkedIn搜索和电子邮件增强功能，帮助查找目标公司的相关联系人。

特点/特性

• LinkedIn搜索利用谷歌自定义搜索API在特定公司中查找人员
• 邮件内容增强/丰富化使用Hunter.io API获取电子邮件地址
• 领域预测利用AI（OpenAI/Gemini）自动预测公司域名
• 灵活模式作为HTTP服务器运行或作为MCP stdio工具运行
• 基于角色的搜索寻找招聘人员、招聘经理和团队成员

安装

git clone https://github.com/Anudeepreddynarala/people-finder-mcp.git
cd people-finder-mcp
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

环境变量

创建一个 .env 包含以下变量的文件：

# Required
GOOGLE_API_KEY=your_google_api_key
SEARCH_ENGINE_ID=your_cse_cx
HUNTER_API_KEY=your_hunter_api_key

# Optional - for domain prediction
OPENAI_API_KEY=optional_openai_key
GEMINIAPI_KEY=optional_gemini_key

# Mode: 'http' for Flask server, 'stdio' for MCP
PEOPLE_FINDER_MODE=http

使用方法

HTTP服务器模式

export PEOPLE_FINDER_MODE=http
python3 people_finder_mcp.py
# Server listens on http://localhost:8081

示例请求：

curl -s -X POST http://localhost:8081/find-people \
  -H 'Content-Type: application/json' \
  -d '{
        "job_title": "Software Engineer",
        "company": "Google",
        "location": "New York",
        "roles": ["Recruiter", "Engineering Manager", "Software Engineer"],
        "max_results": 20
      }' | jq .

MCP 标准工作室模式

export PEOPLE_FINDER_MODE=stdio
python3 people_finder_mcp.py

API终端点

POST /find-people 翻译为中文是：“发送到 /find-people（查找人员）”。不过，在实际应用中，我们通常不会直接翻译URL路径，而是保留其原始形式，同时可以解释其含义。所以，更自然的表达可能是：“访问或发送请求到‘查找人员’（对应URL路径为 /find-people）”

通过电子邮件增强功能在公司中查找人员。

请求体：

{
  "job_title": "Software Engineer",
  "company": "Google",
  "location": "New York",
  "roles": ["Recruiter", "Hiring Manager", "Software Engineer"],
  "max_results": 20
}

回答：

{
  "status": "success",
  "people": [
    {
      "name": "John Doe",
      "title": "Senior Software Engineer",
      "company": "Google",
      "location": "New York, NY",
      "email": "john.doe@google.com",
      "confidence": "high",
      "source": "hunter"
    }
  ],
  "total_found": 15,
  "company_domain": "google.com"
}

MCP 工具

当以stdio模式运行时，会暴露（或显示） find_people 工具：

{
  "name": "find_people",
  "description": "Find people at a company with email enrichment",
  "inputSchema": {
    "type": "object",
    "properties": {
      "job_title": {"type": "string"},
      "company": {"type": "string"},
      "location": {"type": "string"},
      "roles": {"type": "array", "items": {"type": "string"}},
      "max_results": {"type": "integer", "default": 20}
    }
  }
}

安装要求

谷歌自定义搜索API

1. 首选 Google 云控制台
2. 启用自定义搜索API
3. 创建一个API密钥
4. 创建一个自定义搜索引擎 cse.google.com 翻译为中文是“谷歌自定义搜索引擎（Google Custom Search Engine）”
5. 获取您的搜索引擎ID（CX）

Hunter.io API

1. 在（网站/平台）注册 hunter.io
2. 从仪表板获取您的API密钥

可选：用于领域预测的AI API

• OpenAI（开放人工智能研究所）从获取API密钥 platform.openai.com（可翻译为：“OpenAI平台官网”，但通常直接保留原网址形式，因为网址本身具有特定含义且无需翻译）
• 双子座从获取API密钥 makersuite.google.com（可译为）“谷歌制作套件网站”

许可证

麻省理工学院许可证