温室 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

   • Docker Compose 将使用.env文件作为环境变量

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处提供健康检查端点，返回可用工具的列表。

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

麻省理工学院