Paylocity Data Fetcher

🚀 MCP Paylocity サーバー

モデルコンテキストプロトコル (MCP) サーバーで、Paylocity API エンドポイントからデータを取得します。

✨ 主な機能

リソース

このサーバーは Paylocity API リソースを実装しており、以下の特徴があります。

• Paylocity データにアクセスするためのカスタム paylocity:// URI スキーム
• 利用可能なリソースは以下の通りです。
  • paylocity://employees/{company_id} - 会社のすべての従業員を一覧表示
  • paylocity://employees/{company_id}/{employee_id} - 特定の従業員の詳細情報を取得
  • paylocity://earnings/{company_id}/{employee_id} - 特定の従業員の収入データを取得
  • paylocity://codes/{company_id}/{code_resource} - 会社の特定のリソースのコードを取得
  • paylocity://localtaxes/{company_id}/{employee_id} - 特定の従業員の地方税情報を取得
  • paylocity://paystatement/{company_id}/{employee_id}/{year}/{check_date} - 特定の日付の給与明細書の詳細情報を取得

ツール

このサーバーは以下のツールを実装しています。

• fetch_employees - 会社のすべての従業員を取得
  • オプションパラメータ: company_id
• fetch_employee_details - 特定の従業員の詳細情報を取得
  • 必須パラメータ: employee_id、オプションパラメータ: company_id
• fetch_employee_earnings - 特定の従業員の収入データを取得
  • 必須パラメータ: employee_id、オプションパラメータ: company_id
• fetch_company_codes - 会社の特定のリソースのコードを取得
  • 必須パラメータ: code_resource、オプションパラメータ: company_id
• fetch_employee_local_taxes - 特定の従業員の地方税情報を取得
  • 必須パラメータ: employee_id、オプションパラメータ: company_id
• fetch_employee_paystatement_details - 特定の日付の給与明細書の詳細情報を取得
  • 必須パラメータ: employee_id、year、check_date、オプションパラメータ: company_id

📚 ドキュメント

将来的な改善方向は以下の通りです。

• 詳細なエラー処理とログ記録機能の追加
• パフォーマンス向上のためのより効率的なキャッシュメカニズムの実装
• 複数の会社のデータ同期のサポート
• 機能拡張のための追加の API エンドポイントの提供
• コード構造の最適化によるモジュール化と保守性の向上

📄 ライセンス

MIT License

Copyright (c) 2024 MJ Zou (@mjzou)

このソフトウェアおよび関連するドキュメントファイル（「ソフトウェア」）のコピーを取得するすべての人に対して、許諾者は無償で、ソフトウェアを使用、コピー、変更、結合、公開、配布、サブライセンス、および/または販売する権利を許諾し、ソフトウェアを取得した人に対して上記の行為を行うことを許可しますが、以下の条件に従うものとします。

この著作権表示およびこの許諾表示は、ソフトウェアのすべてのコピーまたは重要な部分に含まれるものとします。

ソフトウェアは「現状のまま」提供され、明示または黙示を問わず、商品性、特定の目的への適合性、および非侵害性を含むいかなる保証も伴いません。契約行為、不法行為、またはその他の行為において、作者または著作権者は、ソフトウェアの使用に起因するいかなる請求、損害、またはその他の責任についても一切の責任を負いません。