HireBase MCP Server

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 。

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

一般的なタスク

環境変数

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

テスト

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

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

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

貢献

貢献を歓迎します。

ライセンス

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