Proxycurl MCP

🚀 Proxycurl MCP 服務器

這是一個基於 Node.js 的模型上下文協議（MCP）服務器，它公開了 Proxycurl 的領英數據 API。它可以與任何兼容 MCP 的客戶端（例如 Claude Desktop）配合使用，以訪問領英個人資料數據、公司信息並搜索員工。

✨ 主要特性

• 通過 URL 查找領英個人資料
• 通過 URL 查找領英公司資料
• 按姓名和公司查找人員
• 按職位或關鍵詞搜索公司員工

📦 安裝指南

前提條件

• Node.js（v14 或更高版本）
• Proxycurl API 密鑰（可在 https://nubela.co/proxycurl/ 獲取）
• 兼容 MCP 的客戶端（例如 Claude Desktop）

安裝步驟

1. 克隆此倉庫：

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

2. 安裝依賴項：

npm install

3. 全局安裝 MCP 服務器：

npm install -g .

🚀 快速開始

API 密鑰配置

有兩種方式來配置你的 Proxycurl 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 領英 API
   • 命令：npx
   • 參數：["proxycurl-mcp", "--api-key", "YOUR_ACTUAL_API_KEY"]

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

{
    "mcpServers": [
        {
            "name": "Proxycurl 領英 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 許可證。