HireBase MCP サーバー

HireBase ジョブ API と対話するためのツールを提供するモデル コンテキスト プロトコル (MCP) サーバー。

利用可能なMCPインタラクション

このサーバーは、次の MCP インタラクションを公開します。

ツール

• search_jobs : さまざまな基準 (キーワード、タイトル、場所、給与など) に基づいて HireBase API を使用して求人を検索します。

  • パラメータ: query 、 and_keywords 、 or_keywords 、 not_keywords 、 title 、 category 、 country 、 city 、 location_type 、 company 、 salary_from 、 salary_to 、 salary_currency 、 years_from 、 years_to 、 visa 、 limit 。

• get_job : HireBase ID を使用して特定のジョブの詳細情報を取得します。

  • パラメータ: job_id 。

プロンプト

• create_candidate_profile : 候補者の詳細 (名前、LinkedIn、Web サイト、履歴書のテキスト) に基づいて構造化されたプロンプトを生成し、求職を支援します。

  • パラメータ: name 、 linkedin_url 、 personal_website 、 resume_text 。

Related MCP server: JobDataLake MCP Server

クライアントのセットアップ（例：Claude Desktop、Cursor）

このサーバーを Claude Desktop や Cursor などの MCP クライアントで使用するには、サーバー プロセスを実行するようにクライアントを構成し、オプションで HireBase API キーを提供する必要があります。

1. uvがインストールされていることを確認します: curl -LsSf https://astral.sh/uv/install.sh | sh

2. HireBase API キーを取得する (オプション): HireBaseからキーをリクエストします。これを環境変数 ( HIREBASE_API_KEY ) として設定することも、空のままにすることもできます。

3. クライアントを構成します。

   • uvxの使用:

     • Claude Desktop: claude_desktop_config.jsonを編集します。

       {
         "mcpServers": {
           "hirebase": {
             "command": "uvx",
             "args": [
               "hirebase-mcp" 
             ],
             "env": {
               "HIREBASE_API_KEY": "" 
             }
           }
         }
       }

     • カーソル: [設定] > [MCP] > [サーバーの追加] に移動します。

       • Mac/Linux コマンド: uvx hirebase-mcp (必要に応じてパッケージ名を調整してください)

       • Windows コマンド: cmd

       • Windows 引数: /c 、 uvx 、 hirebase-mcp (必要に応じてパッケージ名を調整してください)

       • 適切なセクションでHIREBASE_API_KEY環境変数を設定します。

   • Python 経由でソースから実行する (代替):

     1. リポジトリをクローンし、クローンした場所をメモします

     2. Claude Desktop: claude_desktop_config.jsonを編集する: GXP2

発達

このプロジェクトでは以下を使用します:

• 依存関係管理と仮想環境のためのuv

• リンティングとフォーマットのためのruff

• ビルドバックエンドとしてのhatch

一般的なタスク

# Setup virtual env
uv venv

# Install dependencies
uv pip install -e .

# install cli tools
uv tool install ruff

# Run linting
ruff check .

# Format code
ruff format .

環境変数

• HIREBASE_API_KEY (必須): HireBase API にアクセスするための API キー。サーバーが求人データへの認証済みリクエストを行うために必要です。

テスト

このプロジェクトでunittest.mock 、コアツールロジックのテストにpytestを使用しています。unittest.mockを使用して、外部API呼び出しのモックをテストします。

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

# Ensure you are in your activated virtual environment (.venv)
uv pip install -e '.[test]'

2. テストを実行します:

# Example command
pytest

貢献

貢献を歓迎します。

ライセンス

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