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