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 配置
claud_desktop_config.json 在…之上smarthr_mcp_server.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() | 役职 |
许可证
麻省理工学院
免责事项
对利用本程序进行的一切行为、所蒙受的损失、损失概不负责。
