Proxycurl MCP

🚀 Proxycurl MCP服务器

Proxycurl MCP服务器是一个基于Node.js的模型上下文协议（MCP）服务器，它公开了Proxycurl的领英（LinkedIn）数据API。该服务器可与任何兼容MCP的客户端（如Claude Desktop）配合使用，以访问领英的个人资料数据、公司信息并搜索员工。

🚀 快速开始

Proxycurl MCP服务器是一个强大的工具，借助它，你可以使用兼容MCP的客户端轻松访问领英数据。下面为你详细介绍使用该服务器的快速开始步骤。

✨ 主要特性

• 按URL查询领英个人资料：通过提供个人的领英URL，可快速获取其详细的个人资料信息。
• 按URL查询领英公司信息：输入公司的领英URL，就能得到该公司的详细资料。
• 按姓名和公司查找人员：根据人员的姓名和所在公司，精准定位其领英资料。
• 按角色或关键词搜索公司员工：在指定公司内，依据角色或关键词筛选员工。

📦 安装指南

克隆仓库

git clone https://github.com/dbogardus/proxycurl-mcp-server.git
cd proxycurl-mcp-server

安装依赖

npm install

全局安装MCP服务器

npm install -g .

🔧 API密钥配置

选项1：环境变量（适用于CLI使用）

设置PROXYCURL_API_KEY环境变量：

export PROXYCURL_API_KEY=your_api_key_here

这种方式适用于开发环境或直接运行CLI时使用。

选项2：Claude Desktop配置示例（推荐Claude Desktop用户使用）

若要配置Claude Desktop以使用此MCP服务器，请按以下步骤操作：

1. 打开Claude Desktop。
2. 点击右上角的设置（⚙️）图标。
3. 选择“模型上下文协议”选项卡。
4. 点击“添加MCP配置”。
5. 输入以下信息：
   • 名称：Proxycurl LinkedIn API
   • 命令：npx
   • 参数：["proxycurl-mcp", "--api-key", "YOUR_ACTUAL_API_KEY"]

Claude Desktop配置文件claude_desktop_config.json示例：

{
    "mcpServers": [
        {
            "name": "Proxycurl LinkedIn API",
            "command": "npx",
            "args": ["proxycurl-mcp", "--api-key", "YOUR_ACTUAL_API_KEY"]
        }
    ]
}

6. 将YOUR_ACTUAL_API_KEY替换为你的Proxycurl API密钥（可从https://nubela.co/proxycurl/ 获取）。
7. 点击“保存”。
8. 重启Claude Desktop以使更改生效。

💻 使用示例

基础用法

配置完成后，你的MCP客户端就可以通过以下工具访问领英数据：

• get_person_profile：通过URL获取个人的领英资料。
  • 示例：linkedinUrl: "https://www.linkedin.com/in/williamhgates"
  • 返回包含工作经历、教育背景、技能、证书等全面的个人资料数据。
• get_company_profile：通过URL获取公司的领英资料。
  • 示例：linkedinUrl: "https://www.linkedin.com/company/microsoft"
  • 返回详细的公司数据，包括描述、规模、行业和特色业务等。
• lookup_person：根据姓名和公司查找个人的领英资料。
  • 重要提示：为获得最佳结果，需要同时提供姓名和公司参数。
  • 示例：name: "Bill Gates", company: "microsoft.com"
  • 若找到匹配的人员，返回其领英URL。
• search_employees：使用角色和关键词筛选条件搜索公司员工。
  • 示例：linkedinUrl: "https://www.linkedin.com/company/microsoft", role: "Software Engineer"
  • 返回包含基本个人资料信息的员工列表。
• search_companies：按名称或域名搜索公司。
  • 示例：query: "Microsoft" 或 query: "microsoft.com", limit: 5
  • 当你仅知道公司名称时，可使用此工具查找其领英URL。
• search_people：根据关键词、职位、公司和地点在领英上搜索人员。
  • 示例：query: "data science", title: "Lead", companyDomain: "microsoft.com", location: "Seattle"
  • 可用于根据技能、职位或行业查找专业人士。
• advanced_search_companies：使用详细的筛选选项对公司进行高级搜索。
  • 示例：country: "US", industry: "technology", employee_count_min: 1000, founded_after_year: 2010
  • 比基本的公司搜索功能更强大，支持在名称和描述字段中使用布尔搜索表达式（AND、OR、NOT），每次搜索最多可返回10,000,000个结果。

📚 详细文档

开发说明

若要修改服务器或添加新功能，请按以下步骤操作：

1. 编辑server.js文件以添加或修改API端点。
2. 运行npm install -g .全局安装你的更改。

本地测试环境（test.env）

对于本地开发和直接运行测试脚本（如tests/目录中的脚本），你可以在项目根目录使用test.env文件来管理API密钥和调试设置。该文件通常包含在.gitignore中，不应提交到代码仓库。

创建一个test.env文件，内容如下：

PROXYCURL_API_KEY=your_actual_proxycurl_api_key_here

将your_actual_proxycurl_api_key_here替换为你的Proxycurl API密钥。测试脚本通常会配置为在该文件存在时加载环境变量。

📄 许可证

本项目采用MIT许可证。