local-only server

The server can only run on the client’s local machine because it depends on local resources.

HR MCP サーバー

Claude Desktop で使用するために構築された HR 操作用の Model Context Protocol (MCP) サーバー。

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

概要

このサーバーはモデルコンテキストプロトコルを実装し、Claude に従業員データと HR 操作への構造化されたアクセスを提供します。

HR MCP サーバーにより、Claude は次のことが可能になります。

従業員の詳細情報を検索する
さまざまな条件で従業員を検索
グローバル休暇申請の提出と管理
HR/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: "bob.vacation@example.com", 
    phone: "+1-555-123-4567" 
  } 
})

4. 翻訳プロンプト: `translate_text`

自動ソース言語検出と HR/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" 
})

翻訳システムは、コンテキストを認識しながら HR 固有の用語を処理し、人材管理のコンテキストで特別な意味を持つ「給付金」、「期間」、「チェック」、「ポジション」などの用語の技術的な意味を保持します。

インストール

# 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

使用法

サーバーを起動します。

npm start

ツールタイプとして「ローカルツール (stdio 経由)」を選択し、サーバーの起動スクリプトへのパスを使用して、Claude Desktop をサーバーに接続します。
Claude のインターフェースを通じて従業員データと HR ツールにアクセスします。

発達

ソースコードは/srcディレクトリにあります
従業員データは/src/data/employees.tsに保存されます。
サーバーは厳密な型付けのTypeScriptを使用します

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

npx ts-node-esm src/index.ts

技術スタック

タイプスクリプト
Node.js
@modelcontextprotocol/sdk - JavaScript/TypeScript 用の MCP SDK
Zod - TypeScript ファーストのスキーマ検証

コード構造

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

集中ログ- 一貫したJSON-RPC形式のログ
ツールベースのアーキテクチャ- 各ツールには明確な責任がある
スキーマ検証- すべての入力に対して Zod による強力な型付け
エラー処理- 明確なエラーメッセージによる包括的な検証
ドキュメント- 複雑なロジックを説明するインラインコメント

ライセンス

マサチューセッツ工科大学

本ソフトウェアおよび関連ドキュメントファイル (以下「本ソフトウェア」) のコピーを入手したすべての人物は、以下の条件に従い、本ソフトウェアを無制限に扱う権利 (使用、コピー、変更、統合、公開、配布、サブライセンス、および/または販売する権利を含みますが、これに限定されません) および本ソフトウェアの提供を受けた人物が同様の行為を行うことを許可する権利を無償で付与されます。

上記の著作権表示およびこの許可通知は、ソフトウェアのすべてのコピーまたは大部分に含めるものとします。

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Claude Desktop が構造化された従業員データにアクセスし、従業員の検索、検索、グローバル休暇申請などの HR 操作を実行できるようにするモデルコンテキストプロトコルサーバー。

HR MCP Server

HR MCP サーバー

概要

ツール

1. `get_employee_info`

2. 従業`search_employees`

3. `request_global_leave`

4. 翻訳プロンプト: `translate_text`

インストール

使用法

発達

技術スタック

コード構造

ライセンス

Appeared in Searches

HR MCP サーバー

概要

ツール

1. get_employee_info

2. 従業search_employees

3. request_global_leave

4. 翻訳プロンプト: translate_text

インストール

使用法

発達

技術スタック

コード構造

ライセンス

Appeared in Searches

1. `get_employee_info`

2. 従業`search_employees`

3. `request_global_leave`

4. 翻訳プロンプト: `translate_text`