SmartHR MCP Server
このプロジェクトは、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() |
役職 |
ライセンス
MIT
免責事項
本プログラムを利用して行う一切の行為、被った損害・損失に対しては、一切の責任を負いかねます。
相关推荐
I find academic articles and books for research and literature reviews.
Confidential guide on numerology and astrology, based of GG33 Public information
Emulating Dr. Jordan B. Peterson's style in providing life advice and insights.
Your go-to expert in the Rust ecosystem, specializing in precise code interpretation, up-to-date crate version checking, and in-depth source code analysis. I offer accurate, context-aware insights for all your Rust programming questions.
Advanced software engineer GPT that excels through nailing the basics.
Converts Figma frames into front-end code for various mobile frameworks.
Take an adjectivised noun, and create images making it progressively more adjective!
Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.
Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx
The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
🧑🚀 全世界最好的LLM资料总结（Agent框架、辅助编程、数据处理、模型训练、模型推理、o1 模型、MCP、小语言模型、视觉语言模型） | Summary of the world's best LLM resources.
Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools
Reviews
4
(1)
user_QdDzPrxF
2025-04-17
I've been using smarthr_mcp_server developed by TomoyaGoto for a while now, and it has been a game-changer for our HR operations. The server is exceptionally reliable, and the seamless integration has boosted our productivity immensely. Highly recommend checking it out on GitHub!