Greenhouse MCP Server

温室 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
   • Docker Compose 将使用.env文件作为环境变量
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处提供健康检查端点，返回可用工具的列表。

贡献

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

执照

麻省理工学院