Smarthr MCP Server

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

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

评分 : 2分

下载量 : 16

更新时间 : 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()`	部分更新等级信息