HR Assistant MCP Server

従業員のオンボード、休暇管理、ミーテング調整、申込オフィスリクエスト対策いた面実用的ローカルHRアシスタントです。MCP互換クライアントに接続しでも、データベースや有料サービスなしで動作します。

システム設計

MCPサーバーがHRワークフローの唯一のエントリーポイントです。従業員、休暇、ミーティング、リクエストの各機能は分離されたモデュールとして実装され、メールの配信はオプンです。デモをスムーズに進められるよう、データはローカルのメモリ上に保持されます。

Related MCP server: multi-mail-mcp

主な特長

• 1回のツール呼び出しで従業員をオンディングできます。

• マネージャーと直下属の関係を持つ従業員ディレクトリを維動します。

• 休暇残高を確認し、休暇日を申請し、休暇履歴を確認できます。

• オリンテションや人事ミーティングをスケジューールし、一覧し、キャンセルできます。

• ノートPC、ヘッドセット、入館バッジなどの場でのリクエストを作成・更新できます。

• ローカル認証情報を設定している場合、SMTP経由で通知を送信できます。

• あらかじめ用意されたサンプル従業員により、すぐにテスティングを始められます。

はじめに

要件: Python 3.10 以降。

git clone https://github.com/sarthak-here/hr-assistant-mcp.git
cd hr-assistant-mcp
python -m pip install -e ".[test]"
python server.py

このサーバーは標準入出で通信します。これはMCPクライアントが期待する方式です。直起動した場合も、対ワ式のチャットプロンプトは表示されません。

変更を加えたら、テストスイートを実行してくてください:

python -m pytest

MCPクライアントへ追加

クライアントの設定には、クローンのプロジェクトのみ絶対パスを使用してってください。

{
  "mcpServers": {
    "hr-assistant": {
      "command": "python",
      "args": ["C:\\path\\to\\hr-assistant-mcp\\server.py"]
    }
  }
}

接続したら、次のいずれののリクエストを試ト試してください:

Show the current employee directory.
Onboard Priya Shah as a Product Analyst reporting to EMP-002.
Check the leave balance for EMP-003.
Create a monitor request for EMP-004.

主なツール

onboard_employeeは従業員レコード、休暇アカウント、および標準的なノートPC・ヘッドセット・入館バッジの各リクエストをまとめて作付します。オリンテションは、日時が確定したら後、別途スケジューーールしてください。

メール設定

メール通はオプンです。send_notificationを利用したい場合は、.env.exampleを.envにコピーし、SMTPの値を設定してください。

Copy-Item .env.example .env

.envファイルはGitから無視されます。他のHR機能はすべて、メール設定なしで動作します。

プロジェクト構成

hr-assistant-mcp/
  assets/             Hand-drawn system-design image
  peopleops/          Domain models and HR workflow managers
  tests/              Automated checks
  server.py           MCP tools
  emails.py           Optional SMTP notifications
  .env.example        Safe configuration template
  pyproject.toml      Project dependencies and test settings