Linkedin MCP

🚀 LinkedIn Model Context Protocol (MCP) Server

LinkedInとのやり取りを行う強力なModel Context Protocolサーバーで、AIアシスタントが求人情報の検索、履歴書や職務経歴書の生成、求職申請の管理をプログラムで行えるようにします。

✨ 主な機能

• 認証機能：セッション管理を備えた安全なLinkedIn認証
• プロフィール管理：LinkedInのプロフィール情報にアクセスし、更新することができます。
• 求人情報検索：柔軟なフィルタオプションで求人情報を検索できます。
• 履歴書生成：LinkedInのプロフィールからカスタマイズされた履歴書を作成します。
• 職務経歴書生成：特定の求職申請に合わせた職務経歴書を生成します。
• 求職申請：求職申請を提出し、追跡することができます。

🔧 技術詳細

このプロジェクトは、Model Context Protocol (MCP)仕様を実装しており、AIアシスタントが標準化されたJSON - RPC形式のリクエストとレスポンスを通じてLinkedInとやり取りできるようにしています。

コンポーネント:

• MCPハンドラ：リクエストを適切なサービスハンドラにルーティングします。
• APIモジュール：LinkedInとのやり取りに特化したモジュール（認証、求人情報検索、プロフィールなど）
• コアプロトコル：リクエスト/レスポンスの構造とデータモデルを定義します。
• ユーティリティ：設定管理とヘルパー関数を提供します。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/linkedin-mcp.git
cd linkedin-mcp

# 仮想環境を作成してアクティブ化する
python -m venv venv
source venv/bin/activate  # Windowsの場合: venv\Scripts\activate

# 依存関係をインストールする
pip install -r requirements.txt

設定

プロジェクトのルートに.envファイルを作成し、以下の変数を設定してください。

# LinkedInの認証情報
LINKEDIN_USERNAME=your_email@example.com
LINKEDIN_PASSWORD=your_password

# API設定
OPENAI_API_KEY=your_openai_api_key
SESSION_DIR=sessions
DATA_DIR=data

💻 使用例

サーバーの起動

python server.py

サンプルのMCPリクエスト

認証

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "linkedin.login",
  "params": {
    "username": "user@example.com",
    "password": "password123"
  }
}

求人情報の検索

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "linkedin.searchJobs",
  "params": {
    "filter": {
      "keywords": "software engineer",
      "location": "New York, NY",
      "distance": 25
    },
    "page": 1,
    "count": 20
  }
}

履歴書の生成

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "linkedin.generateResume",
  "params": {
    "profileId": "user123",
    "template": "standard",
    "format": "pdf"
  }
}

利用可能なメソッド

開発

プロジェクト構造

linkedin-mcp/
├── README.md
├── requirements.txt
├── server.py
├── data/
│   ├── applications/
│   ├── companies/
│   ├── cover_letters/
│   ├── jobs/
│   ├── profiles/
│   └── resumes/
├── linkedin_mcp/
│   ├── api/
│   │   ├── auth.py
│   │   ├── cover_letter_generator.py
│   │   ├── job_application.py
│   │   ├── job_search.py
│   │   ├── profile.py
│   │   └── resume_generator.py
│   ├── core/
│   │   ├── mcp_handler.py
│   │   └── protocol.py
│   └── utils/
│       └── config.py
├── sessions/
└── templates/
    ├── cover_letter/
    │   └── standard.html
    └── resume/
        └── standard.html

テストの実行

pytest

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細についてはLICENSEファイルを参照してください。

謝辞

• LinkedIn APIドキュメント
• Model Context Protocol仕様