Greenhouse MCP サーバー

Greenhouse Harvest API 用のモデルコンテキストプロトコル（MCP）サーバー実装。このサーバーは、MCP を介して Greenhouse の採用および応募者追跡システムと連携するためのツールを提供します。

特徴

• フィルタリングオプションを使用してジョブを一覧表示する
• ページ区切りで候補をリストする
• フィルタリングによるアプリケーションの一覧表示
• アプリケーションをステージ間で移動する
• さらに多くの機能が近日中に登場します!

ローカル開発のセットアップ

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

2. 環境変数を設定します。

• .env.exampleを.envにコピーする
• Greenhouse API キーを.envに追加します。

3. プロジェクトをビルドします。

4. サーバーを起動します。

展開

GitHub デプロイメント（推奨）

1. このリポジトリを GitHub アカウントにフォークまたはクローンします。
2. GitHub リポジトリのシークレットを設定します。
   • リポジトリの「設定」>「シークレットと変数」>「アクション」に移動します。
   • APIキーを使用して、 GREENHOUSE_API_KEYという名前の新しいシークレットを追加します。
3. GitHub Actions を有効にする:
   • リポジトリのアクションタブに移動します
   • ワークフローがまだ有効になっていない場合は有効にします
4. コードをメイン ブランチにプッシュします。

5. GitHub Actions ワークフローは自動的に次の処理を実行します。
   • コードをビルドしてテストする
   • Dockerイメージを作成する
   • イメージをGitHub Container Registry (ghcr.io)にプッシュする
6. デプロイされたコンテナを使用するには:

ローカルでのDockerの使用

1. システムに Docker と Docker Compose がインストールされていることを確認してください。
2. 環境を構成します。
   • .envファイルに正しいGREENHOUSE_API_KEYが含まれていることを確認してください
   • .envファイルはDocker Composeによって環境変数として使用されます。
3. コンテナをビルドして起動します。

4. ログを確認します:

5. サーバーを停止します。

手動展開

サーバー上での手動展開の場合:

1. サーバーにNode.js（v20以降）をインストールします
2. リポジトリをクローンします。

3. 依存関係をインストールします:

4. 環境変数を設定します。

5. プロジェクトをビルドします。

6. PM2 から開始します (本番環境に推奨):

利用可能なツール

リストジョブ

オプションのステータス フィルタリングを使用して、Greenhouse 内のすべてのジョブを一覧表示します。

パラメータ:

• status （オプション）：ステータス（「オープン」、「クローズ」、「ドラフト」）で求人をフィルタリングします。

候補者リスト

ページ区切りのサポートを使用して、Greenhouse 内の候補を一覧表示します。

パラメータ:

• per_page （オプション）: ページあたりの候補者数
• page （オプション）: ページ番号

アプリケーション一覧

フィルタリング オプションを使用して、Greenhouse 内のアプリケーションを一覧表示します。

パラメータ:

• job_id (オプション): ジョブIDでフィルタリング
• status （オプション）: アプリケーションのステータスでフィルタリング

移動アプリケーション

アプリケーションを別のステージに移動します。

パラメータ:

• application_id (必須): 移動するアプリケーションのID
• stage_id (必須): 対象ステージのID

健康チェック

サーバーは、利用可能なツールのリストを返す/toolsのヘルスチェック エンドポイントを提供します。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

マサチューセッツ工科大学