Loxo MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Loxo 招聘平台 API 交互的工具。该服务器使 AI 助手能够执行各种与招聘相关的任务，例如管理候选人、职位、活动和呼叫队列。

安装

# 克隆仓库
git clone [repository-url]
cd loxo-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

配置

将提供的 .env.example 文件复制到 .env 并填写您的值：

cp .env.example .env

然后使用您的配置更新 .env 文件：

LOXO_API_KEY=your_api_key
LOXO_DOMAIN=app.loxo.co
LOXO_AGENCY_SLUG=your_agency_slug

必需的环境变量：

• LOXO_API_KEY: 您的 Loxo API 密钥
• LOXO_AGENCY_SLUG: 您在 Loxo 中的机构 slug
• LOXO_DOMAIN: (可选) 默认为 'app.loxo.co'

可用工具

活动管理

• get-activity-types: 检索可用活动类型列表
• spark-search-activity-types: 从 Spark Search 获取活动类型
• get-todays-tasks: 获取今天的所有任务和计划活动
• schedule-activity: 安排未来的活动（电话、会议等）
• log-activity: 为候选人或职位记录活动

呼叫队列管理

• get-call-queue: 查看当前呼叫队列
• add-to-call-queue: 将候选人或联系人添加到呼叫队列

候选人管理

• search-candidates: 在 Loxo 中搜索候选人
• get-candidate: 获取有关特定候选人的详细信息
• add-note: 向候选人添加备注

职位管理

• search-jobs: 在 Loxo 中搜索职位
• get-job: 获取有关特定职位的详细信息
• add-note: 向职位添加备注

开发

# 在具有 watch 模式的开发模式下运行
npm run dev

# 构建项目
npm run build

# 启动服务器
npm start

类型安全

服务器使用 Zod 进行运行时类型验证：

• 环境变量
• 工具输入参数
• API 响应

错误处理

服务器包括全面的错误处理：

• 环境验证
• API 请求失败
• 无效的工具参数
• 未知的工具请求

架构

• 使用模型上下文协议 SDK 构建
• 通过 stdio 进行通信，以便与 AI 助手无缝集成
• 使用 TypeScript 实现类型安全和更好的开发者体验
• 实现对 Loxo 平台的 RESTful API 调用