Smarthr MCP Server

🚀 SmartHR MCP サーバー

このプロジェクトは SmartHR API 用に MCP (モデルコンテキストプロトコル) サーバーを実装しています。SmartHR の社員、部署、職位、雇用形態、等級などの情報を MCP ツールとして扱うことができます。

🚀 クイックスタート

このサーバーを使用することで、SmartHR API から取得した情報を MCP ツールとして活用できます。以下に具体的な手順を説明します。

✨ 主な機能

• SmartHR API との連携を通じて、社員、部署、職位、雇用形態、等級などの情報を取得できます。
• MCP ツールとしてこれらの情報を管理し、操作することができます。

📦 インストール

環境変数（.env）の設定

SmartHR API と通信するためには、以下の環境変数が必要です。

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

手順

1. リポジトリのクローンまたはダウンロード
2. 環境変数（.env）の設定
3. Claude for Desktop の設定 claud_desktop_config.json に smarthr_mcp_server.json の内容を追加します。
4. Claude for Desktop の再起動

   % killall "Claude"
   % open -a Claude
   

💻 使用例

基本的な使用法

このサーバーを使用することで、SmartHR API から取得した情報を 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/

📄 ライセンス

MIT

⚠️ 免責事項

本プログラムを使用して行われたすべての行為およびそれによって生じたすべての損害や損失については、使用者が全ての責任を負い、プロジェクト提供者は一切の責任を負いません。