HireBase MCP Server

HireBase MCP サーバー

HireBase Job API と連携するためのツールを提供する Model Context Protocol（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、ウェブサイト、履歴書のテキスト）に基づいて構造化されたプロンプトを生成し、求人検索を支援します。
  • パラメーター：name、linkedin_url、personal_website、resume_text。

クライアントのセットアップ（例：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": "" 
             }
           }
         }
       }
       

     • Cursor： Settings > MCP > Add Server を開きます。
       • Mac/Linux のコマンド： uvx hirebase-mcp（必要に応じてパッケージ名を調整してください）
       • Windows のコマンド： cmd
       • Windows の引数： /c、uvx、hirebase-mcp（必要に応じてパッケージ名を調整してください）
       • 該当するセクションで HIREBASE_API_KEY 環境変数を設定します。

   • Python でソースから実行する場合（代替方法）：

     1. リポジトリをクローンし、クローン先を確認します
     2. Claude Desktop： claude_desktop_config.json を編集します。

     {
         "mcpServers": {
             "hirebase": {
                 "command": "uv",
                 "args": [
                     "run",
                     "--with",
                     "mcp[cli]",
                     "--with",
                     "requests",
                     "mcp",
                     "run",
                     "PATH_TO_REPO/src/hirebase_mcp/server.py"
                 ]
             }
         }
     }
     

開発

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

• 依存関係の管理と仮想環境に 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 キーです。求人データに対する認証済みリクエストを行うために、サーバーで必要です。

テスト

このプロジェクトでは、コアとなるツールのロジックのテストに 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 ファイルをご覧ください。