Greenhouse MCP サーバー

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

特徴

• フィルタリングオプションを使用してジョブを一覧表示する

• ページ区切りで候補をリストする

• フィルタリングによるアプリケーションの一覧表示

• アプリケーションをステージ間で移動する

• さらに多くの機能が近日中に登場します!

Related MCP server: MCP Ashby Connector

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

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

npm install

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

• .env.exampleを.envにコピーする

• Greenhouse API キーを.envに追加します。

GREENHOUSE_API_KEY=your_api_key_here

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

npm run build

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

npm start

展開

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

1. このリポジトリを GitHub アカウントにフォークまたはクローンします。

2. GitHub リポジトリのシークレットを設定します。

   • リポジトリの「設定」>「シークレットと変数」>「アクション」に移動します。

   • APIキーを使用して、 GREENHOUSE_API_KEYという名前の新しいシークレットを追加します。

3. GitHub Actions を有効にする:

   • リポジトリのアクションタブに移動します

   • ワークフローがまだ有効になっていない場合は有効にします

4. コードをメイン ブランチにプッシュします。

git add .
git commit -m "Initial commit"
git push origin main

5. GitHub Actions ワークフローは自動的に次の処理を実行します。

   • コードをビルドしてテストする

   • Dockerイメージを作成する

   • イメージをGitHub Container Registry (ghcr.io)にプッシュする

6. デプロイされたコンテナを使用するには:

docker pull ghcr.io/your-username/mcp-greenhouse:latest
docker run -p 3001:3001 -e GREENHOUSE_API_KEY=your_api_key ghcr.io/your-username/mcp-greenhouse:latest

ローカルでのDockerの使用

1. システムに Docker と Docker Compose がインストールされていることを確認してください。

2. 環境を構成します。

   • .envファイルに正しいGREENHOUSE_API_KEYが含まれていることを確認してください

   • .envファイルはDocker Composeによって環境変数として使用されます。

3. コンテナをビルドして起動します。

docker-compose up -d

4. ログを確認します:

docker-compose logs -f

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

docker-compose down

手動展開

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

1. サーバーにNode.js（v20以降）をインストールします

2. リポジトリをクローンします。

git clone <repository-url>
cd mcp-greenhouse

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

npm install

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

cp .env.example .env
# Edit .env with your Greenhouse API key

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

npm run build

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

npm install -g pm2
pm2 start dist/index.js --name mcp-greenhouse

利用可能なツール

リストジョブ

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

パラメータ:

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

候補者リスト

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

パラメータ:

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

• page （オプション）: ページ番号

アプリケーション一覧

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

パラメータ:

• job_id (オプション): ジョブIDでフィルタリング

• status （オプション）: アプリケーションのステータスでフィルタリング

移動アプリケーション

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

パラメータ:

• application_id (必須): 移動するアプリケーションのID

• stage_id (必須): 対象ステージのID

健康チェック

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

貢献

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

ライセンス

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