Proxycurl MCP

🚀 Proxycurl MCP Server

これは、Node.jsベースのModel Context Protocol (MCP)サーバーで、ProxycurlのLinkedInデータAPIを公開します。任意のMCP互換クライアント（例：Claude Desktop）と組み合わせて、LinkedInのプロフィールデータ、会社情報の取得や従業員の検索を行うことができます。

✨ 主な機能

• URLを指定してLinkedInの個人プロフィールを検索
• URLを指定してLinkedInの会社プロフィールを検索
• 名前と会社名を指定して人物を検索
• 役割やキーワードを指定して会社の従業員を検索

📦 インストール

前提条件

• 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キーを設定する方法は2つあります。

オプション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. 「Model Context Protocol」タブを選択します。

4. 「Add MCP Configuration」をクリックします。

5. 以下の情報を入力します。

   • 名前: Proxycurl LinkedIn API
   • コマンド: npx
   • 引数: ["proxycurl-mcp", "--api-key", "YOUR_ACTUAL_API_KEY"]

   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. 「Save」をクリックします。

8. Claude Desktopを再起動して変更を適用します。

💻 使用例

基本的な使用法

設定が完了すると、MCPクライアントは以下のツールを通じてLinkedInデータにアクセスできます。

• get_person_profile: URLを指定して人物のLinkedInプロフィールを取得

  • 例: linkedinUrl: "https://www.linkedin.com/in/williamhgates"
  • 経歴、学歴、スキル、資格証明などの包括的なプロフィールデータを返します。

• get_company_profile: URLを指定して会社のLinkedInプロフィールを取得

  • 例: linkedinUrl: "https://www.linkedin.com/company/microsoft"
  • 説明、規模、業界、特長などの詳細な会社データを返します。

• lookup_person: 名前と会社名を指定して人物のLinkedInプロフィールを検索

  • 重要: 最適な結果を得るには、名前と会社の両方のパラメーターが必要です。
  • 例: name: "Bill Gates", company: "microsoft.com"
  • 見つかった場合、人物のLinkedIn URLを返します。

• search_employees: 役割やキーワードフィルターを使用して会社の従業員を検索

  • 例: linkedinUrl: "https://www.linkedin.com/company/microsoft", role: "Software Engineer"
  • 基本的なプロフィール情報を含む従業員のリストを返します。

• search_companies: 名前またはドメインで会社を検索

  • 例: query: "Microsoft" または query: "microsoft.com", limit: 5
  • 会社名のみがわかっている場合に、LinkedInの会社URLを見つけるために使用します。

• search_people: キーワード、タイトル、会社、場所を指定してLinkedIn上の人物を検索

  • 例: 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