Loxo MCP Server

🚀 Loxo MCP 服務器

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_AGENCY_SLUG=your_agency_slug
LOXO_DOMAIN=app.loxo.co

所需的環境變量：

• LOXO_API_KEY：你的 Loxo API 密鑰
• LOXO_AGENCY_SLUG：你在 Loxo 中的機構標識符
• LOXO_DOMAIN：（可選）默認為 'app.loxo.co'

開發

# 在開發模式下運行，帶有監控功能
npm run dev

# 構建項目
npm run build

# 啟動服務器
npm start

✨ 主要特性

• 豐富的工具集：提供活動管理、電話隊列管理、候選人管理和工作機會管理等多種工具。
• 類型安全：使用 Zod 進行運行時類型驗證，確保環境變量、工具輸入參數和 API 響應的類型安全。
• 全面的錯誤處理：包含環境變量驗證、API 請求失敗、無效工具參數和未知工具請求等全面的錯誤處理功能。
• 良好的架構設計：使用 Model Context Protocol SDK 構建，通過 stdio 進行通信，便於與 AI 助手無縫集成，採用 TypeScript 實現類型安全和更好的開發體驗，並實現與 Loxo 平臺的 RESTful API 調用。

📦 安裝指南

克隆倉庫

git clone [repository-url]
cd loxo-mcp-server

安裝依賴

npm install

構建項目

npm run build

💻 使用示例

基礎用法

以下是一些常用工具的使用示例：

活動管理

• 獲取所有可用活動類型

# 執行命令獲取所有可用活動類型
get-activity-types

• 獲取今天的所有任務和計劃活動

# 執行命令獲取今天的所有任務和計劃活動
get-todays-tasks

電話隊列管理

• 查看當前的電話隊列

# 執行命令查看當前的電話隊列
get-call-queue

候選人管理

• 在 Loxo 中搜索候選人

# 執行命令在 Loxo 中搜索候選人
search-candidates

工作機會管理

• 在 Loxo 中搜索工作機會

# 執行命令在 Loxo 中搜索工作機會
search-jobs

高級用法

安排未來的活動

# 執行命令安排未來的活動（電話、會議等）
schedule-activity

向候選人添加備註

# 執行命令向候選人添加備註
add-note

🔧 技術細節

• 類型安全：該服務器使用 Zod 進行運行時類型驗證，涵蓋環境變量、工具輸入參數和 API 響應，確保程序在運行時的類型正確性。
• 錯誤處理：服務器具備全面的錯誤處理功能，包括環境變量驗證、API 請求失敗、無效工具參數和未知工具請求等情況的處理，提高了系統的穩定性和健壯性。
• 架構設計：使用 Model Context Protocol SDK 構建，通過 stdio 進行通信，實現了與 AI 助手的無縫集成。採用 TypeScript 編寫，提供了類型安全和更好的開發體驗，同時實現了與 Loxo 平臺的 RESTful API 調用。