HR MCP Server

HR MCP Server

Claude Desktop での使用を目的として構築された、人事業務向けの Model Context Protocol（MCP）サーバーです。

https://github.com/user-attachments/assets/4cb89115-daf2-4647-81d2-aadd9e0dd29e

概要

このサーバーは、Model Context Protocol を実装し、Claude が従業員データや人事業務に構造化された形でアクセスできるようにします。

HR MCP Server を使うと、Claude は次のことができます。

• 従業員の詳細情報を検索する
• さまざまな条件で従業員を検索する
• グローバルな休暇申請を提出、管理する
• 人事／HCM の文脈を考慮してテキストを翻訳する

アーキテクチャの詳細については、ARCHITECTURE.md を参照してください。

ツール

このサーバーは、Claude に次のツールを提供します。

1. get_employee_info

ID を指定して特定の従業員の詳細情報を取得します。個人情報、雇用情報、スキル、福利厚生などが含まれます。

// Example usage:
get_employee_info({ employee_id: "E001" })

// With sensitive information:
get_employee_info({ employee_id: "E001", include_sensitive: true })

2. search_employees

柔軟な照合オプションを使って、さまざまな条件で従業員を検索します。氏名、部署、スキル、勤務地など、多数の項目で検索できます。

// Basic search:
search_employees({ 
  query: { department: "Engineering" } 
})

// Advanced search:
search_employees({ 
  query: { 
    location: "Seattle", 
    performance_rating: 5 
  }, 
  options: { 
    sort_by: "hireDate", 
    output_format: "detailed" 
  } 
})

// Search with sensitive information:
search_employees({ 
  query: { salary_min: 100000 }, 
  options: { include_sensitive: true } 
})

3. request_global_leave

複数の国を訪問する従業員のグローバルな休暇申請を提出します。承認フローやコンプライアンスに関するリマインダーにも対応しています。

// Basic request:
request_global_leave({ 
  employee_id: "E002", 
  start_date: "2025-05-01", 
  end_date: "2025-05-15", 
  reason: "Family vacation", 
  countries: ["USA", "UK"] 
})

// With custom contact info:
request_global_leave({ 
  employee_id: "E002", 
  start_date: "2025-05-01", 
  end_date: "2025-05-15", 
  reason: "Family vacation", 
  countries: ["USA", "UK"], 
  contact_info: { 
    email: "[email protected]", 
    phone: "+1-555-123-4567" 
  } 
})

4. 翻訳プロンプト：translate_text

任意の言語のテキストを指定した対象言語に翻訳します。原文の言語を自動検出し、人事／HCM 用語に特に配慮します。

// Basic translation:
translate_text({ 
  text: "Les employés doivent soumettre leurs feuilles de temps avant la fin de la période.", 
  target_language: "English" 
})

この翻訳システムは、人事特有の用語を文脈に応じて処理します。「福利厚生」「期間」「確認」「職位」など、人的資本管理の文脈で特別な意味を持つ用語の技術的な意味を保持します。

インストール

# Clone the repository
git clone https://github.com/yourusername/hr-mcp-server.git
cd hr-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

使用方法

1. サーバーを起動します。

npm start

2. ツールの種類として「Local Tool (via stdio)」を選択し、サーバーの起動スクリプトへのパスを指定して、Claude Desktop をサーバーに接続します。

3. Claude のインターフェースから従業員データや人事ツールにアクセスします。

開発

• ソースコードは /src ディレクトリにあります
• 従業員データは /src/data/employees.ts に保存されています
• このサーバーは、厳格な型付けを使用する TypeScript で構築されています

開発モードで実行するには：

npx ts-node-esm src/index.ts

技術スタック

• TypeScript
• Node.js
• @modelcontextprotocol/sdk - JavaScript／TypeScript 用 MCP SDK
• Zod - TypeScript を第一に考えたスキーマ検証

コード構成

このサーバーは、クリーンで保守しやすいコードを重視して構成されています。

• ログの一元管理 - 一貫性のある JSON-RPC 形式のログ
• ツールベースのアーキテクチャ - 各ツールが明確な役割を担います
• スキーマ検証 - すべての入力を Zod で強力に型付けします
• エラー処理 - 明確なエラーメッセージを伴う包括的な検証
• ドキュメント - 複雑なロジックを説明するインラインコメント

ライセンス

MIT

Copyright (c) 2024

本ソフトウェアおよび関連するドキュメントファイル（以下「本ソフトウェア」）の複製を取得するすべての者に対し、以下の条件に従い、本ソフトウェアを無制限に取り扱うことを無償で許可します。これには、本ソフトウェアを使用、複製、変更、結合、公開、配布、サブライセンス、および／または販売する権利が含まれます。また、本ソフトウェアを提供する者に対しても同様の権利を許可します。

上記の著作権表示および本許諾表示は、本ソフトウェアのすべての複製または実質的な部分に含めるものとします。

本ソフトウェアは「現状有姿」で提供され、明示または黙示を問わず、いかなる保証もありません。これには、商品性、特定目的への適合性、および権利非侵害に関する保証が含まれますが、これらに限定されません。作者または著作権者は、契約、不法行為、その他の行為のいずれに基づく場合であっても、本ソフトウェアまたはその使用、その他の取り扱いに起因または関連して生じる請求、損害、その他の責任について、一切責任を負いません。