Tbensonwest Loxo MCP Server

🚀 Loxo MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーであり、Loko採用プラットフォームのAPIとのやり取りを可能にするツールを提供しています。このサーバーにより、AIアシスタントは候補者、職種、活動、通話キューの管理など、さまざまな採用関連のタスクを実行することができます。

🚀 クイックスタート

このセクションでは、Loxo MCPサーバーのクイックスタート方法を説明します。以下の手順に従って、サーバーをセットアップしてください。

📦 インストール

# リポジトリをクローンする
git clone [リポジトリのURL]
cd loxo-mcp-server

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

✨ 主な機能

設定

提供されている.env.exampleファイルをコピーして.envにリネームし、必要な値を入力します。

cp .env.example .env

次に、.envファイル内の設定を更新します。

LOXO_API_KEY=あなたのAPIキー
LOXO_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：職種にメモを追加します。

開発

# 開発モードで実行し、リアルタイム監視を有効にする
npm run dev

# プロジェクトをビルドする
npm run build

# サーバーを起動する
npm start

型安全

このサーバーは、Zodを使用して実行時の型検証を行っています。対象は以下の通りです。

• 環境変数
• ツールの入力パラメーター
• APIレスポンス

エラー処理

サーバーには包括的なエラー処理機能が備わっています。具体的には以下のエラーを処理します。

• 環境変数の検証
• APIリクエストの失敗
• 無効なツールパラメーター
• 未知のツールリクエスト

アーキテクチャ

• モデルコンテキストプロトコルSDKを使用して構築されています。
• 標準入出力を介してAIアシスタントと通信します。
• TypeScriptを使用して型安全と良好な開発体験を実現しています。
• LokoプラットフォームのRESTful API呼び出しを実装しています。