🚀 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服务器，请按以下步骤操作：
- 打开Claude Desktop。
- 点击右上角的设置（⚙️）图标。
- 选择“模型上下文协议”选项卡。
- 点击“添加MCP配置”。
- 输入以下信息：
- 名称：
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"]
}
]
}
- 将
YOUR_ACTUAL_API_KEY替换为你的Proxycurl API密钥（可从https://nubela.co/proxycurl/ 获取）。 - 点击“保存”。
- 重启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个结果。
- 示例：
📚 详细文档
开发说明
若要修改服务器或添加新功能，请按以下步骤操作：
- 编辑
server.js文件以添加或修改API端点。 - 运行
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许可证。