Smarthr MCP Server

SmartHR MCP服务器项目，提供与SmartHR API对接的模型上下文协议服务，支持员工、部门、职位等数据的操作管理。

客户数据平台开发者工具 #人事管理 #API对接 #数据同步 #企业服务 .Python

评分 : 2分

下载量 : 8.8K

更新时间 : 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

Claude for Desktop 的配置

在 claud_desktop_config.json 中追加 smarthr_mcp_server.json 的内容。

重启 Claude for Desktop

% killall "Claude"
% open -a Claude

✨ 主要特性

本项目能够将 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()`	部分更新等级信息