Hirebase MCP

🚀 HireBase MCP サーバー

HireBase の仕事 API と相互作用するためのツールを提供する Model Context Protocol (MCP) サーバーです。

🚀 クイックスタート

このサーバーは、HireBase の仕事 API との相互作用を可能にするツールを提供します。以下に、サーバーの利用方法や設定に関する詳細を説明します。

✨ 主な機能

利用可能な 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": [
        "hfirebase-mcp" 
      ],
      "env": {
        "HIREBASE_API_KEY": "" 
      }
    }
  }
}

- **Cursor**: 設定 > MCP > サーバーの追加に移動します。
  - **Mac/Linux コマンド**: `uvx hirebase-mcp`（必要に応じてパッケージ名を調整）
  - **Windows コマンド**: `cmd`
  - **Windows Args**: `/c`, `uvx`, `hfirebase-mcp`（必要に応じてパッケージ名を調整）
  - 適切な領域で `HIREBASE_API_KEY` 環境変数を設定します。

• ソースコードから実行する場合（代替方法）:
  1. リポジトリをクローンし、クローンした場所を覚えておきます。
  2. Claude Desktop: claude_desktop_config.json を編集します。

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

🔧 技術詳細

開発

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

• uv を使用した依存関係管理と仮想環境
• ruff を使用したコードチェックとフォーマット
• hatch をビルドバックエンドとして使用

一般的なタスク

# 仮想環境の設定
uv venv

# 依存関係のインストール
uv pip install -e .

# CLI ツールのインストール
uv tool install ruff

# コードチェックの実行
ruff チェック .

# コードのフォーマット
ruff フォーマット .

📚 ドキュメント

環境変数

• HIREBASE_API_KEY: HireBase API との認証に使用するキーです。

テスト

MCP サーバーをテストするには、以下のコマンドを実行します。

uv run --with mcp[cli] --with requests mcp 実行

🤝 貢献

コードの貢献や問題の報告は、GitHub リポジトリ をご利用ください。

📄 ライセンス

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