Greenhouse MCP 服务器

一个用于 Greenhouse Harvest API 的模型上下文协议 (MCP) 服务器实现。此服务器提供通过 MCP 与 Greenhouse 的招聘和应聘者追踪系统交互的工具。

功能

• 列出职位，带有过滤选项
• 列出候选人，带有分页
• 列出申请，带有过滤
• 在阶段之间移动申请
• 更多功能即将推出！

本地开发设置

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. Fork 或克隆此存储库到您的 GitHub 帐户。

2. 设置 GitHub 存储库密钥：

   • 转到您的存储库的 Settings > Secrets and variables > Actions
   • 添加一个名为 GREENHOUSE_API_KEY 的新密钥，其中包含您的 API 密钥

3. 启用 GitHub Actions：

   • 转到您的存储库的 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
# 使用您的 Greenhouse API 密钥编辑 .env

5. 构建项目：

npm run build

6. 使用 PM2 启动（推荐用于生产环境）：

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

可用工具

list_jobs

列出 Greenhouse 中的所有职位，带有可选的状态过滤。

参数：

• status (可选): 按状态过滤职位 ('open', 'closed', 'draft')

list_candidates

列出 Greenhouse 中的候选人，带有分页支持。

参数：

• per_page (可选): 每页的候选人数量
• page (可选): 页码

list_applications

列出 Greenhouse 中的申请，带有过滤选项。

参数：

• job_id (可选): 按职位 ID 过滤
• status (可选): 按申请状态过滤

move_application

将申请移动到不同的阶段。

参数：

• application_id (必需): 要移动的申请的 ID
• stage_id (必需): 目标阶段的 ID

健康检查

服务器在 /tools 提供一个健康检查端点，该端点返回可用工具的列表。

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT