使用说明
人员查找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
- 首选 Google 云控制台
- 启用自定义搜索API
- 创建一个API密钥
- 创建一个自定义搜索引擎 cse.google.com 翻译为中文是“谷歌自定义搜索引擎（Google Custom Search Engine）”
- 获取您的搜索引擎ID（CX）
Hunter.io API
- 在（网站/平台）注册 hunter.io
- 从仪表板获取您的API密钥
可选：用于领域预测的AI API
- **OpenAI（开放人工智能研究所）**从获取API密钥 platform.openai.com（可翻译为：“OpenAI平台官网”，但通常直接保留原网址形式，因为网址本身具有特定含义且无需翻译）
- 双子座从获取API密钥 makersuite.google.com（可译为）“谷歌制作套件网站”
许可证
麻省理工学院许可证
