🚀 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