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'

開發

# 以開發模式運行，並啟用即時監控
npm run dev

# 構建項目
npm run build

# 啟動服務器
npm start

✨ 主要特性

可用工具

活動管理

• 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 調用。