Greenhouse MCP 服务器

一个用于 Greenhouse 收获 API 的 Model Context Protocol (MCP) 服务器实现。该服务器提供了通过 MCP 与 Greenhouse 的招聘和申请人跟踪系统交互的工具。

功能

• 带过滤选项的职位列表
• 分页显示候选人列表
• 带过滤选项的应用列表
• 在不同阶段之间移动应用
• 更多功能即将推出！

本地开发设置

1. 安装依赖项：

npm install

1. 配置环境变量：

• 将 .env.example 复制为 .env
• 将您的 Greenhouse API 密钥添加到 .env 中：

GREENHOUSE_API_KEY=your_api_key_here

1. 构建项目：

npm run build

1. 启动服务器：

npm start

部署

GitHub 部署（推荐）

1. 将此仓库分叉或克隆到您的 GitHub 账户中。

2. 设置 GitHub 仓库密钥：

   • 转到您仓库的设置 > Secrets and variables > Actions
   • 添加一个新的名为 GREENHOUSE_API_KEY 的密钥，值为您自己的 API 密钥

3. 启用 GitHub Actions：

   • 转到您仓库的 Actions 标签页
   • 如果还没有启用工作流，请启用它们

4. 将代码推送到主分支：

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

1. GitHub Actions 工作流将自动执行以下操作：

   • 构建并测试您的代码
   • 创建 Docker 镜像
   • 将镜像推送到 GitHub Container Registry (ghcr.io)

2. 使用已部署的容器：

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

1. 查看日志：

docker-compose logs -f

1. 停止服务器：

docker-compose down

手动部署

对于在服务器上的手动部署：

1. 在您的服务器上安装 Node.js（版本 20 或更高）
2. 克隆仓库：

git clone <repository-url>
cd mcp-greenhouse

1. 安装依赖项：

npm install

1. 设置环境变量：

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

1. 构建项目：

npm run build

1. 使用 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