Paylocity Data Fetcher

🚀 MCP Paylocity 服务器

一个模型上下文协议 (MCP) 服务器，用于从 Paylocity API 端点获取数据，为数据获取提供了便捷的解决方案。

🚀 快速开始

此 MCP Paylocity 服务器搭建了与 Paylocity API 端点的桥梁，可有效获取所需数据。

✨ 主要特性

资源

该服务器实现了 Paylocity API 资源，具备以下特点：

• 采用自定义 paylocity:// URI 方案，方便访问 Paylocity 数据。
• 提供丰富的可用资源：
  • 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。

版权所有 (c) 2024 MJ Zou (@mjzou)

许可方在此授予任何获得该软件及其关联文档文件（“软件”）副本的人免费使用、复制、修改、合并、发布、分发、 sublicense 和/或出售该软件的权利，以及允许向获得该软件的人提供该软件以便其进行上述行为，但需遵守以下条件：

本版权声明和本许可声明应包含在所有副本或该软件的所有实质性部分中。

软件按“现状”提供，不附带任何形式的保证，包括但不限于明示或暗示的保证，如适销性、特定用途适用性以及非侵权保证。无论是在合同行为、侵权行为或其他任何行为中，作者或版权持有者均不对因使用该软件而产生的任何声明、损害或其他责任承担任何责任。