Smarthr MCP Server

SmartHR MCP服務器項目，提供與SmartHR API對接的模型上下文協議服務，支持員工、部門、職位等數據的操作管理。

客戶數據平臺開發者工具 #人事管理 #API對接 #數據同步 #企業服務 .Python

評分 : 2分

下載量 : 17

更新時間 : 2025-04-28

什麼是SmartHR MCP Server?

這是一個基於Model Context Protocol (MCP)的中間件服務器，專門設計用於與SmartHR人力資源管理系統對接。它允許非技術用戶通過標準化的接口訪問和管理員工信息、組織架構等HR數據。

如何使用SmartHR MCP Server?

只需簡單的環境配置和API密鑰設置，即可通過Claude等支持MCP協議的客戶端工具訪問所有HR數據功能。

適用場景

適用於需要集成SmartHR數據到其他系統的場景，如員工自助服務門戶、數據分析平臺或自動化工作流系統。

主要功能

全面數據訪問支持員工、部門、職位、僱傭類型等所有核心HR數據的讀取和修改

完整CRUD操作提供創建、讀取、更新、刪除等完整數據操作功能

高級搜索支持按多種條件篩選和搜索員工信息

優勢與侷限性

優勢

簡化SmartHR API的複雜接口

標準化數據訪問方式

支持多種客戶端工具集成

侷限性

需要SmartHR企業賬號和API權限

部分高級功能需要額外配置

如何使用

獲取API密鑰

從SmartHR開發者門戶獲取有效的API訪問令牌

配置環境

創建.env文件並設置SMARTHR_API_KEY等必要參數

啟動服務

運行主程序啟動MCP服務器

客戶端配置

在Claude等客戶端工具中導入smarthr_mcp_server.json配置文件

使用案例

新員工入職通過MCP服務器自動創建新員工記錄並分配部門

組織架構分析獲取各部門員工數量統計

常見問題

需要哪些權限才能使用此服務?

支持哪些客戶端工具?

數據同步是即時的嗎?

🚀 SmartHR MCP 服務器

本項目針對 SmartHR API 實現了 MCP（模型上下文協議）服務器。藉助該服務器，可將 SmartHR 中的員工、部門、職位、僱傭形式和等級等信息作為 MCP 工具進行處理。

🚀 快速開始

環境變量（.env）

為了與 SmartHR API 通信，需要以下環境變量：

SMARTHR_API_BASE_URL=https://app.smarthr.jp/api
SMARTHR_API_KEY=YOUR_SMARTHR_API_TOKEN

使用方法

克隆或下載倉庫
設置環境變量（.env）
Claude for Desktop 的配置 在 claud_desktop_config.json 中追加 smarthr_mcp_server.json 的內容
重啟 Claude for Desktop

% killall "Claude"
% open -a Claude

✨ 主要特性

實現了針對 SmartHR API 的 MCP 服務器，可將 SmartHR 多種信息作為 MCP 工具處理。
提供了豐富的支持工具，涵蓋註冊、刪除、獲取、列表、搜索、更新和部分更新等操作。

📦 安裝指南

此部分文檔未提供具體安裝命令，若有相關需求，可參考上述使用方法進行操作。

💻 使用示例

本項目文檔未提供代碼示例，若在使用過程中有代碼相關需求，可依據上述支持工具列表中的函數進行開發。

📚 詳細文檔

組件結構

smarthr-mcp-server/
│
├── .env_sample
├── .gitignore
├── main.py
├── pyproject.toml
├── README.md
├── requirements.txt
├── smarthr_mcp_server.json         # MCP 工具的定義和命令信息（供 MCP 兼容客戶端使用）
├── uv.lock
│
└── smarthr_mcp_server/
    ├── server.py                   # 基於 FastMCP 的 MCP 服務器實現
    ├── smarthr_client.py          # 負責與 SmartHR API 進行通信的客戶端模塊
    └── smarthr_mcp_server.egg-info/

支持工具列表

註冊相關

函數名	描述
`smarthr_create_crew()`	創建員工
`smarthr_create_department()`	創建部門
`smarthr_create_position()`	創建職位
`smarthr_create_employment_type()`	創建僱傭形式
`smarthr_create_grade()`	創建等級

刪除相關

函數名	描述
`smarthr_delete_crew()`	刪除員工
`smarthr_delete_department()`	刪除部門
`smarthr_delete_position()`	刪除職位
`smarthr_delete_employment_type()`	刪除僱傭形式
`smarthr_delete_grade()`	刪除等級

獲取相關

函數名	描述
`smarthr_get_crew()`	獲取員工信息
`smarthr_get_departments()`	獲取所有部門
`smarthr_get_positions()`	獲取所有職位
`smarthr_get_employment_types()`	獲取所有僱傭形式
`smarthr_get_grades()`	獲取所有等級

列表相關

函數名	描述
`smarthr_list_relations()`	獲取關係列表

搜索相關

函數名	描述
`smarthr_search_crews()`	搜索員工

更新相關

函數名	描述
`smarthr_update_crew()`	更新員工信息
`smarthr_update_department()`	更新部門信息
`smarthr_update_position()`	更新職位信息
`smarthr_update_employment_type()`	更新僱傭形式
`smarthr_update_grade()`	更新等級信息

部分更新相關

函數名	描述
`smarthr_partial_update_department()`	部分更新部門信息
`smarthr_partial_update_position()`	部分更新職位信息
`smarthr_partial_update_employment_type()`	部分更新僱傭形式
`smarthr_partial_update_grade()`	部分更新等級信息