MCP 服务器

SmartHR MCP Server

TomoyaGoto

开发者工具

访问服务器

README

SmartHR MCP 服务器

这个项目是对应 SmartHR API 的 MCP (Model Context Protocol) 服务器。可以将 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/

环境变量（.env）

与 SmartHR API 通信需要以下环境变量。

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

使用方法

克隆或下载仓库
设置环境变量（.env）
Claude for Desktop 的设置

将 smarthr_mcp_server.json 的内容追加到 claud_desktop_config.json
重启 Claude for Desktop
```
% killall "Claude"
% open -a Claude
```

对应工具一览

注册相关

函数名	说明
`smarthr_create_crew()`	员工
`smarthr_create_department()`	部门
`smarthr_create_dependent()`	家族信息
`smarthr_create_employment_type()`	雇用形式
`smarthr_create_grade()`	等级
`smarthr_create_job_category()`	职种
`smarthr_create_job_title()`	职位

删除相关

函数名	说明
`smarthr_delete_crew()`	员工
`smarthr_delete_dependent()`	家族信息
`smarthr_delete_employment_type()`	雇用形式
`smarthr_delete_grade()`	等级
`smarthr_delete_job_category()`	职种
`smarthr_delete_job_title()`	职位

废止相关

函数名	说明
`smarthr_discontinue_department()`	部门

获取相关

函数名	说明
`smarthr_get_crew()`	员工
`smarthr_get_department()`	部门
`smarthr_get_dependent()`	家族信息
`smarthr_get_employment_type()`	雇用形式
`smarthr_get_grade()`	等级
`smarthr_get_job_category()`	职种
`smarthr_get_job_title()`	职位

邀请相关

函数名	说明
`smarthr_invite_crew()`	员工

列表获取相关

函数名	说明
`smarthr_list_crews()`	员工
`smarthr_list_departments()`	部门
`smarthr_list_dependents()`	家族信息
`smarthr_list_employment_types()`	雇用形式
`smarthr_list_grades()`	等级
`smarthr_list_job_categories()`	职种
`smarthr_list_job_titles()`	职位
`smarthr_list_relations()`	续柄

部分更新相关

函数名	说明
`smarthr_partial_update_department()`	部门
`smarthr_partial_update_dependent()`	家族信息
`smarthr_partial_update_employment_type()`	雇用形式
`smarthr_partial_update_grade()`	等级
`smarthr_partial_update_job_category()`	职种
`smarthr_partial_update_job_title()`	职位

搜索相关

函数名	说明
`smarthr_search_crews()`	员工

更新相关

函数名	说明
`smarthr_update_crew()`	员工
`smarthr_update_department()`	部门
`smarthr_update_dependent()`	家族信息
`smarthr_update_employment_type()`	雇用形式
`smarthr_update_grade()`	等级
`smarthr_update_job_category()`	职种
`smarthr_update_job_title()`	职位