People Data Labs MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，它封装了 People Data Labs API。它提供了对 People Data Labs 各种数据模型和搜索功能的全面访问。

功能

个人 API

• 个人资料丰富: 使用额外的数据丰富个人资料
• 人员搜索: 使用类似 SQL 的查询搜索符合特定条件的人员
• 批量个人资料丰富: 在单个请求中丰富多个个人资料

公司 API

• 公司资料丰富: 使用额外的数据丰富公司资料
• 公司搜索: 搜索符合特定条件的公司

额外的数据模型

• 学校搜索: 搜索符合特定条件的学校
• 位置搜索: 搜索符合特定条件的位置
• 职位搜索: 搜索符合特定条件的职位
• 技能搜索: 搜索符合特定条件的技能

工具

• 自动补全: 获取各种字段的自动补全建议

设置

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 使用提供的配置脚本之一配置您的 People Data Labs API 密钥

配置

自动配置

该项目包括用于自动配置 Claude Desktop 和 VS Code 的 MCP 服务器的脚本：

对于 Claude Desktop：

npm run config:claude

对于 VS Code：

npm run config:vscode

这两个脚本将执行以下操作：

1. 检查配置文件是否存在，如果需要则创建
2. 提示您输入 People Data Labs API 密钥
3. 将 MCP 服务器配置添加到适当的文件中
4. 提供下一步的操作说明

手动配置

如果您希望手动配置 MCP 服务器，则需要将其添加到您的 MCP 设置文件中。该文件的位置取决于您的环境：

• 对于 VS Code: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
• 对于 Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json

在您的 MCP 设置文件中的 mcpServers 对象中添加以下配置：

{
  "mcpServers": {
    "peopledatalabs": {
      "command": "node",
      "args": ["path/to/peopledatalabs-mcp/build/index.js"],
      "env": {
        "PDL_API_KEY": "your-api-key-here"
      }
    }
  }
}

替换：

• path/to/peopledatalabs-mcp/build/index.js 为实际构建的 index.js 文件路径
• your-api-key-here 为您的实际 People Data Labs API 密钥

可用工具

个人 API 工具

enrich_person

使用 People Data Labs 的额外数据丰富个人资料。

参数：

• email (字符串，可选)：个人的电子邮件地址
• phone (字符串，可选)：个人的电话号码
• name (字符串，可选)：个人的全名
• profile (字符串数组，可选)：个人的社交媒体资料链接
• location (字符串，可选)：个人的位置（城市、州/省、国家）
• company (字符串，可选)：个人工作的公司名称
• title (字符串，可选)：个人的职位
• min_likelihood (数字，可选)：匹配的最低可能性分数（0-1）

注意： 必须至少提供 email、phone、name 或 profile 中的一个。

search_people

使用类似 SQL 的查询来搜索符合特定条件的人。

参数：

• query (字符串，必填)：用于搜索人的类似 SQL 的查询
• size (数字，可选)：返回的结果数量（最大 100）

bulk_person_enrich

在单个请求中丰富多个个人资料。

参数：

• requests (数组，必填)：个人资料丰富的请求数组

公司 API 工具

enrich_company

用额外的数据丰富公司资料。

参数：

• name (字符串，可选)：公司的名称
• website (字符串，可选)：公司的网站
• profile (字符串数组，可选)：公司的社交媒体资料链接
• ticker (字符串，可选)：公司的股票代码

注意： 必须至少提供 name、website、profile 或 ticker 中的一个。

search_companies

搜索符合特定条件的公司。

参数：

• query (字符串，必填)：用于搜索公司的类似 SQL 的查询
• size (数字，可选)：返回的结果数量（最大 100）

学校 API 工具

search_schools

搜索符合特定条件的学校。

参数：

• query (字符串，必填)：用于搜索学校的类似 SQL 的查询
• size (数字，可选)：返回的结果数量（最大 100）

地点 API 工具

search_locations

搜索符合特定条件的地点。

参数：

• query (字符串，必填)：用于搜索地点的类似 SQL 的查询
• size (数字，可选)：返回的结果数量（最大 100）

职位 API 工具

search_job_titles

搜索符合特定条件的职位。

参数：

• query (字符串，必填)：用于搜索职位的类似 SQL 的查询
• size (数字，可选)：返回的结果数量（最大 100）

技能 API 工具

search_skills

搜索符合特定条件的技能。

参数：

• query (字符串，必填)：用于搜索技能的类似 SQL 的查询
• size (数字，可选)：返回的结果数量（最大 100）

实用工具

autocomplete

为部分查询获取自动完成建议。

参数：

• field (字符串，必填)：要自动完成的字段（公司、学校、职位、技能、地点）
• text (字符串，必填)：要自动完成的部分文本
• size (数字，可选)：返回的结果数量（最大100）

示例用法

人员 API 示例

<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>enrich_person</tool_name>
<arguments>
{
  "email": "john.smith@example.com"
}
</arguments>
</use_mcp_tool>

<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>search_people</tool_name>
<arguments>
{
  "query": "SELECT * FROM person WHERE location='San Francisco' AND job_title='Software Engineer'",
  "size": 5
}
</arguments>
</use_mcp_tool>

公司 API 示例

<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>enrich_company</tool_name>
<arguments>
{
  "name": "Apple Inc."
}
</arguments>
</use_mcp_tool>

<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>search_companies</tool_name>
<arguments>
{
  "query": "SELECT * FROM company WHERE location='New York' AND industry='Finance'",
  "size": 5
}
</arguments>
</use_mcp_tool>

自动完成示例

<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>autocomplete</tool_name>
<arguments>
{
  "field": "company",
  "text": "Goog"
}
</arguments>
</use_mcp_tool>

许可证

Apache 2.0