smarthr_mcp_server

🚀 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() | 部分更新等级信息 |

📄 许可证

本项目采用 MIT 许可证。

⚠️ 免责声明

使用本程序进行的一切行为及由此产生的一切损害和损失，均由使用者自行负责，项目方不承担任何责任。