tbensonwest_loxo-mcp-server

🚀 Loxo MCP 服务器

Loxo MCP 服务器是一个模型上下文协议（MCP）服务器，它提供了与 Loko 招聘平台 API 交互的工具。借助此服务器，AI 助手能够执行各类招聘相关任务，如管理候选人、职位、活动以及通话队列等。

🚀 快速开始

安装

# 克隆仓库
git clone [仓库地址]
cd loxo-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

配置

复制提供的 .env.example 文件并重命名为 .env，然后填写您的值：

cp .env.example .env

接着更新 .env 文件中的配置：

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

所需环境变量：

• LOXO_API_KEY：您的 Loko API 密钥
• LOXO_AGENCY_SLUG：您机构在 Loko 中的标识符
• 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：在 Loko 中搜索候选人
• get-candidate：获取特定候选人的详细信息
• add-note：向候选人添加备注

职位管理

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

类型安全

该服务器使用 Zod 进行运行时类型验证，涵盖环境变量、工具输入参数以及 API 响应等方面。

错误处理

服务器具备全面的错误处理功能，包括环境变量验证、API 请求失败、无效工具参数以及未知工具请求等情况的处理。

架构

• 使用模型上下文协议 SDK 构建
• 通过标准输入输出与 AI 助手通信
• 使用 TypeScript 实现类型安全和更好的开发体验
• 实现了 Loko 平台的 RESTful API 调用

💻 使用示例

开发

# 以开发模式运行，并启用实时监控
npm run dev

# 构建项目
npm run build

# 启动服务器
npm start