Careerjet MCPv2

🚀 Careerjet Job Search MCP Server

このプロジェクトは、Careerjet API を使用して、求人情報検索機能を提供する MCP (Model Context Protocol) サーバーです。

✨ 主な機能

• 求人情報検索：キーワードと地域を指定して求人情報を検索できます。
• 高度なフィルタリング：契約形態、勤務時間、給与順などの条件で絞り込めます。
• 多言語対応：50以上の国と言語をサポートしています。
• MCP互換：AIアシスタントとの統合が容易です。

📦 インストール

必要条件

• Python 3.11以上
• pip
• 有効なCareerjet APIキー

手順

1. 依存関係をインストールします：

pip install -r requirements.txt

2. APIキーを設定します：

   • デフォルトのAPIキー：371d48447450886ce16b718533cca6f2
   • 独自のAPIキーを取得するには、Careerjet Partners を参照してください。

3. MCPサーバーを起動します：

python server.py

Dockerを使用したインストール

# Dockerイメージをビルドします
docker build -t careerjet-mcp .

# コンテナを起動します
docker run -it careerjet-mcp

💻 使用例

MCPツール

1. search_jobs_tool

求人情報を検索する機能です。

パラメーター：

• keywords (必須)：検索するキーワード
• location (必須)：勤務地
• locale：言語/国コード (デフォルト: en_US)
• affid：Careerjet APIキー (デフォルト: 371d48447450886ce16b718533cca6f2)
• sort：並び替えの種類 (relevance, date, salary)
• pagesize：ページあたりの結果数
• contracttype：契約形態 (p=正社員, c=契約社員, t=臨時雇用)
• contractperiod：勤務時間 (f=フルタイム, p=パートタイム)

例：

# ロンドンでのPython開発者の求人情報を検索します
result = search_jobs_tool(
    keywords="python developer",
    location="London",
    locale="en_GB",
    affid="371d48447450886ce16b718533cca6f2",
    sort="salary",
    pagesize=20
)

2. get_job_details_tool

求人情報の詳細を取得する機能です（基本的な実装）。

サポートされるロケール

• en_US - アメリカ合衆国
• en_GB - イギリス
• de_DE - ドイツ
• fr_FR - フランス
• es_ES - スペイン
• it_IT - イタリア
• tr_TR - トルコ
• その他...

📚 ドキュメント

Smithery.yaml

MCPクライアントで使用するための smithery.yaml ファイルが用意されています。

startCommand:
  type: stdio
  configSchema:
    type: object
    properties:
      affid:
        type: string
        description: "Careerjet Affiliate ID"
        default: "371d48447450886ce16b718533cca6f2"
      locale:
        type: string
        description: "デフォルトの言語コード"
        default: "en_US"

Affiliate ID

Careerjet APIを使用するには、Affiliate IDが必要です。無料アカウントを作成するには、以下の手順を実行してください。

1. Careerjet Partners ページにアクセスします。
2. パートナーアカウントを作成します。
3. 取得したAffiliate IDを使用します。

デフォルトのAPIキー：371d48447450886ce16b718533cca6f2

🔧 技術詳細

API制限

• Careerjet APIには使用頻度の制限があります。
• 大量のリクエストを行う場合は、Careerjetと連絡を取ってください。
• レート制限が適用される場合があります。

開発

プロジェクト構造

├── app.py              # 主要な業務ロジック
├── server.py           # MCPサーバーの実装
├── requirements.txt    # Pythonの依存関係
├── smithery.yaml      # MCPの設定
├── Dockerfile         # Dockerの設定
├── test_samsun.py     # テストファイル
└── README.md          # このファイル

テスト

# Samsunに関するテスト
python test_samsun.py

# 簡単なテスト
python -c "from app import search_jobs; print(search_jobs('python', 'London'))"

📄 ライセンス

MITライセンス

コントリビューション

1. リポジトリをフォークします。
2. 新しい機能ブランチを作成します。
3. 変更をコミットします。
4. プルリクエストを送信します。

連絡先

このプロジェクトは GitHub 上で開発されています。

バージョン履歴

• v2.0：APIキーが更新され、機能が改善されました。
• v1.0：最初のバージョン